환경  MySQL 8.0 · 8.4 LTS · 9.x · 도커 공식 이미지 기준 · 2026-11-23 확인

MySQL 을 8.4 로 올리면 mysql_native_password 로 만든 계정은 로그인이 안 됩니다. 8.4 부터 이 인증 플러그인이 기본으로 꺼져 있고, 9.0 부터는 아예 빠졌기 때문입니다. 비밀번호는 맞는데 화면에는 Access denied 만 떠서 비밀번호부터 의심하게 되는 게 함정입니다. my.cnf 에 default_authentication_plugin 을 적어 둔 서버라면 로그인 이전에 서버가 아예 안 뜹니다. 도커에서 mysql:8 태그를 쓰고 있었다면 이미지를 새로 받는 순간 8.0 이 아니라 8.4 가 올라옵니다.

MySQL 8.0·8.4·9.x 인증 설정 차이 표

같은 이름이 버전마다 다르게 동작합니다. 8.0 에서는 새 계정의 기본 플러그인만 caching_sha2_password 로 바뀌었고, 예전 방식인 mysql_native_password 도 그대로 쓸 수 있었습니다. 업그레이드로 넘어온 기존 계정은 원래 플러그인을 그대로 들고 왔습니다. 그래서 8.0 까지는 옛 계정이 아무 문제 없이 돌아갑니다.

8.0.34 에서 mysql_native_password 가 폐기 예정(deprecated)으로 바뀌었고, 8.4.0 에서 서버 쪽 플러그인이 기본 비활성화됐습니다. 함께 default_authentication_plugin 변수도 8.4.0 에서 없어지고 authentication_policy 가 그 역할을 넘겨받았습니다. 9.0.0 부터는 플러그인 자체가 서버에서 빠져서 켜는 옵션도 남아 있지 않습니다.

도커 공식 이미지 태그도 같이 봐야 합니다. 2026-11-23 기준으로 mysql:8 과 mysql:8.4 는 8.4.13 을, mysql:lts 와 mysql:9 는 9.7.4 를, mysql:latest 는 26.10.0 을 가리킵니다. mysql:8.0 태그는 2026년 5월 이후 갱신이 없습니다. compose 파일에 mysql:8 이라고만 적어 두었다면 docker compose pull 한 번에 메이저 동작이 바뀝니다.

항목                              8.0              8.4 LTS             9.x
------------------------------------------------------------------------------------
새 계정 기본 플러그인             caching_sha2     caching_sha2        caching_sha2
mysql_native_password 서버 쪽     사용 가능        기본 꺼짐           제거됨
                                  (8.0.34 폐기예정) (켜려면 =ON)
default_authentication_plugin     있음             제거(unknown)       없음
authentication_policy             있음             이걸로 대체         그대로
--mysql-native-password 옵션      없음             8.4.0 에 추가       없음(플러그인 제거)

도커 태그 (2026-11-23)
mysql:8, mysql:8.4  -> 8.4.13
mysql:9, mysql:lts  -> 9.7.4
mysql:latest        -> 26.10.0

버전별 인증 관련 기본값과 설정 이름. 도커 태그가 가리키는 버전은 시간이 지나면 다시 바뀝니다

8.4 는 옛 플러그인을 끄고, 9.0 은 지웠습니다. 계정은 그대로 남아 있어서 로그인 순간에야 드러납니다.

8.4로 올리면 바뀌는 동작 두 가지

첫째, mysql_native_password 계정의 접속이 막힙니다. 클라이언트는 ERROR 1045 Access denied 를 받고, 서버는 같은 내용을 에러 로그에 남깁니다. 이 계정으로 CREATE USER 나 ALTER USER 를 하려 해도 ERROR 1524 Plugin 'mysql_native_password' is not loaded 로 거절됩니다. 비밀번호를 바꿔 보려다 이 오류를 만나면 그제야 원인이 보입니다.

둘째, 설정 파일에 default_authentication_plugin=mysql_native_password 가 남아 있으면 서버가 시작을 거부합니다. 8.0 시절 옛 클라이언트를 살리려고 많이 넣던 줄입니다. 8.4 는 이 변수를 모르기 때문에 unknown variable 오류를 찍고 Aborting 으로 끝납니다. 도커라면 컨테이너가 재시작을 반복하고, 앱 쪽에서는 연결 거부만 보입니다.

앱이 쓰는 커넥터가 오래된 경우도 같이 터질 수 있습니다. caching_sha2_password 를 모르는 클라이언트는 Authentication plugin 'caching_sha2_password' cannot be loaded 나 The server requested authentication method unknown to the client 같은 오류를 냅니다. 이건 8.0 으로 올릴 때 이미 겪었어야 할 문제인데, 지금까지 native 설정으로 덮어 두었다면 8.4 에서 한꺼번에 나옵니다.

# 업그레이드한 서버가 설정 파일을 받아들이는지, 실제로 띄우지 않고 검사
mysqld --validate-config
# [ERROR] [MY-000067] [Server] unknown variable 'default_authentication_plugin=mysql_native_password'.
# [ERROR] [MY-010119] [Server] Aborting

# 도커라면 새 이미지로 같은 검사
docker run --rm -v "$PWD/my.cnf:/etc/mysql/conf.d/my.cnf:ro" mysql:8.4 mysqld --validate-config

# 이미 띄웠다면 에러 로그에서 확인
docker logs mysql 2>&1 | grep -E 'unknown variable|Aborting|native'

--validate-config 는 서버를 정상 모드로 띄우지 않고 설정만 검사합니다. 오류가 있으면 종료 코드 1 입니다. 컨테이너 이름 mysql 은 예시입니다

어떤 계정이 mysql_native_password 인지 확인하는 법

올리기 전에 mysql.user 표에서 plugin 열을 봅니다. 여기 mysql_native_password 가 찍힌 계정이 8.4 에서 막힐 계정입니다. 앱 접속 계정, 복제 계정, 백업 스크립트 계정처럼 사람이 아닌 계정이 대개 여기에 걸려 있습니다. 8.0 에서 미리 이 목록을 비워 두면 업그레이드 날 할 일이 확 줄어듭니다.

authentication_policy 값도 같이 봅니다. 8.4 에서 새 계정의 기본 플러그인은 이 변수가 정합니다. 설정 파일을 8.0 에서 그대로 들고 왔다면 default_authentication_plugin 줄은 지우고, 기본값을 바꿀 이유가 없다면 authentication_policy 는 건드리지 않는 편이 낫습니다.

-- 계정별 인증 플러그인
SELECT user, host, plugin
  FROM mysql.user
 ORDER BY plugin, user;

-- 지금 서버 버전과 새 계정 기본 정책
SELECT VERSION(), @@authentication_policy;

-- 서버 쪽 비밀번호 인증 플러그인 상태
SELECT plugin_name, plugin_status
  FROM information_schema.plugins
 WHERE plugin_name LIKE '%password%';

8.0 에서 미리 돌려 보고, 8.4 로 올린 뒤에도 한 번 더 돌립니다

caching_sha2_password로 바꾸는 순서

제대로 고치는 방법은 계정을 caching_sha2_password 로 옮기는 것입니다. ALTER USER 로 플러그인과 비밀번호를 같이 다시 지정합니다. 원래 비밀번호를 그대로 쓰더라도 BY 뒤에 다시 적어 줍니다. 앱 설정의 비밀번호는 그대로 두면 됩니다.

바꾼 뒤에는 연결 방식을 확인합니다. caching_sha2_password 계정은 TLS 연결이거나, TLS 가 없으면 RSA 키로 비밀번호를 주고받을 수 있는 연결이어야 합니다. TLS 없이 TCP 로 붙는 앱이라면 첫 접속에서 실패할 수 있습니다. 명령줄 클라이언트는 --get-server-public-key 로 서버 공개키를 받아 오고, 커넥터는 각자 같은 옵션이 따로 있으니 그 설정을 찾아 켭니다.

당장 계정을 다 못 바꾸면 8.4 에서는 [mysqld] 에 mysql_native_password=ON 을 넣어 임시로 살릴 수 있습니다. 다만 9.0 부터는 이 스위치가 없습니다. 8.4 에서 켜 두고 잊어버리면 다음 업그레이드에서 같은 장애를 다시 만납니다. 켰다면 계정 전환 일정까지 같이 잡아 둡니다.

-- 8.0 에서 미리 바꾸거나, 8.4 에서 임시로 native 를 켠 상태에서 실행
ALTER USER 'app'@'%' IDENTIFIED WITH caching_sha2_password BY '기존_비밀번호';

-- 바뀌었는지 확인
SELECT user, host, plugin FROM mysql.user WHERE user = 'app';

-- 8.4 에서만 가능한 임시 조치 (my.cnf, 9.0 이후 없음)
-- [mysqld]
-- mysql_native_password=ON

app 과 '%' 는 예시입니다. 실제 계정과 호스트로 바꿉니다

업그레이드 뒤 접속 확인 방법

서버가 떴다면 앱이 쓰는 계정으로 앱과 같은 경로를 따라 접속해 봅니다. 루트 계정으로 소켓 접속이 된다고 앱이 붙는다는 뜻은 아닙니다. TCP 로, 앱과 같은 호스트에서, 같은 계정으로 붙어 봐야 caching_sha2_password 의 TLS·RSA 조건까지 함께 확인됩니다.

도커 compose 를 쓰면 이미지 태그를 mysql:8.4 처럼 마이너까지 적어 둡니다. mysql:8 이나 latest 는 언젠가 또 움직입니다. 올릴 때는 태그를 바꾸는 커밋 하나로 남기면, 나중에 무엇이 바뀌었는지 찾기 쉽습니다.

# 앱과 같은 조건(TCP, 같은 계정)으로 접속 시험
mysql -h 127.0.0.1 -P 3306 -u app -p -e 'SELECT CURRENT_USER(), VERSION();'

# TLS 없이 붙어야 하는 환경이라면 공개키를 받아 오는 옵션으로 확인
mysql -h 127.0.0.1 -P 3306 -u app -p --ssl-mode=DISABLED --get-server-public-key -e 'SELECT 1;'

# compose 이미지 태그가 무엇을 가리키는지
docker compose images
docker image inspect mysql:8 --format '{{index .Config.Env}}' | tr ' ' '\n' | grep MYSQL_VERSION

app 은 예시 계정입니다. 공식 이미지는 MYSQL_VERSION 환경변수에 실제 버전을 담고 있습니다

조치 후 확인할 것

  • 8.0 에서 SELECT user, host, plugin FROM mysql.user 로 mysql_native_password 계정 목록을 뽑았는가
  • my.cnf 와 conf.d 에서 default_authentication_plugin 줄을 지우고 mysqld --validate-config 를 통과했는가
  • 앱·복제·백업 계정을 caching_sha2_password 로 바꾼 뒤 앱과 같은 TCP 경로로 접속해 봤는가
  • 8.4 에서 mysql_native_password=ON 을 임시로 켰다면 계정 전환 일정을 같이 잡았는가
  • compose 파일의 이미지 태그를 mysql:8 대신 mysql:8.4 처럼 고정했는가

8.4 업그레이드에서 막히는 지점은 두 군데입니다. 설정 파일의 default_authentication_plugin 줄이 서버를 못 뜨게 하고, mysql_native_password 계정이 접속을 못 합니다. 둘 다 8.0 에 있을 때 미리 지울 수 있습니다. 임시로 native 를 켜는 건 8.4 에서만 통하는 조치라서, 켰다면 계정 전환까지 끝내야 9.x 로 넘어갈 수 있습니다.