[MySQL] ER_NOT_SUPPORTED_AUTH_MODE 에러

문제

MySQL 8.0에서 NodeJS의 mysql 라이브러리를 사용하여 Connect 하는 중 다음과 같은 에러가 발생했다.

 

  code: 'ER_NOT_SUPPORTED_AUTH_MODE',
  errno: 1251,
  sqlMessage: 'Client does not support authentication protocol requested by server; consider upgrading MySQL client',
  sqlState: '08004',
  fatal: true

 

 

 

원인

MySQL 8 이전 버전에서는 기본 패스워드 플러그인이 mysql_native_password 설정되어있지만,

이후에 caching_sha2_password가 기본이 되면서 기존 mysql 플러그인으로는 지원되지 않는 방식이기 때문에 접속을 하지 못한다.

 

mysql_native_password와 caching_sha2_password의 차이는 보안성에 있다.

https://dev.mysql.com/doc/refman/8.0/en/caching-sha2-pluggable-authentication.html

MySQL :: MySQL 8.0 Reference Manual :: 6.4.1.2 Caching SHA-2 Pluggable Authentication

요약하자면, mysql_native_password는 비밀번호 노출의 위험이 있어 caching_sha2_password를 사용한다는 것.

 

 

해결

방법 1. mysql2 라이브러리 사용

가장 간단한 방법이다. API들이 기존 mysql 라이브러리와 호환되어있어 라이브러리를 포함시키는 부분만 바꾸면 된다.

 

mysql 설치

npm install mysql2

 

사용 부분 교체

import * as mysql from 'mysql2';

 

 

 

방법 2. (비추천)

보안의 위험성때문에 당연지사, 방법 1로 해결해야 되지만 피치 못할 사정으로 방법 1을 적용할 수 없는 상황이라면

다음과 같이 패스워드 플러그인을 바꾸는 방법으로 해결한다.

 

ALTER USER '계정 이름' IDENTIFIED WITH mysql_native_password BY '계정 비밀번호';