mysql 8.0 > 8.4 올릴 때 주의

작성자

카테고리:

MySQL 8.0에서 8.4 LTS로 업그레이드할 때 반드시 점검해야 하는 주요 항목과 설정 방법입니다.

1. 주요 변경사항 및 주의점

  • mysql_native_password 플러그인 제거
    • MySQL 8.4부터는 이전 기본 인증 방식인 mysql_native_password 플러그인이 기본적으로 비활성화/제거되었습니다 (caching_sha2_password가 기본).
    • 컨테이너 커맨드에 --default-authentication-plugin=mysql_native_password 설정이 남아 있으면 컨테이너 실행(Start) 자체가 실패합니다.
  • 삭제된 설정 옵션(my.cnf / command)
    • 8.0에서 사용되던 일부 설정 매개변수가 8.4에서 완전히 제거되었습니다.
    • 대표적으로 innodb_log_file_size, innodb_log_files_in_group 등의 옵션이 설정 파일이나 실행 명령에 포함되어 있다면 시작 시 에러가 발생합니다.
  • 자동 딕셔너리 업그레이드
    • 별도의 mysql_upgrade 명령을 실행할 필요 없이, 컨테이너 시작 시 데이터 디렉터리(var/lib/mysql)를 감지하여 자동으로 데이터 딕셔너리 업그레이드를 진행합니다.
  • 다운그레이드 불가
    • 메이저 버전 업그레이드 이후에는 8.4의 데이터 디렉터리로 8.0을 다시 실행(다운그레이드)할 수 없으므로 사전 백업이 필수입니다.

2. Compose 파일 수정 및 조치 예시

기존 docker-compose.yml에서 호환되지 않는 옵션을 제거해야 정상 작동합니다.

YAML

version: '3.8'

services:
  mysql:
    image: mysql:8.4
    container_name: global-mysql
    # command에서 --default-authentication-plugin=mysql_native_password 제거
    command:
      - --character-set-server=utf8mb4
      - --collation-server=utf8mb4_unicode_ci
    environment:
      MYSQL_ROOT_PASSWORD: "your_password"
      TZ: Asia/Seoul
    volumes:
      - global_db_data:/var/lib/mysql

volumes:
  global_db_data:
    external: true

3. 클라이언트 접속 문제 해결 (caching_sha2_password)

오래된 DB 클라이언트 라이브러리나 웹 애플리케이션(예: 구버전 PHP, Node.js 등)이 caching_sha2_password 인증을 지원하지 못해 접속 에러가 발생할 경우, DB에 접속하여 해당 계정의 인증 방식을 변경해 주어야 합니다.

SQL

-- 8.4 접속 후 인증 플러그인 변경 (필요 시)
ALTER USER 'user_name'@'%' IDENTIFIED WITH caching_sha2_password BY 'your_password';
FLUSH PRIVILEGES;

현재 상황 조회하려면

//전체사용자 조회
SELECT user, host, plugin FROM mysql.user;

//특정사용자만 조회
SELECT user, host, plugin FROM mysql.user WHERE user = 'root';

구버전 방식 사용중인 계정이 있다면

ALTER USER 'dogak_user'@'%' IDENTIFIED WITH caching_sha2_password BY '기존비밀번호';
ALTER USER 'jisim_user'@'%' IDENTIFIED WITH caching_sha2_password BY '기존비밀번호';
ALTER USER 'test_user'@'%' IDENTIFIED WITH caching_sha2_password BY '기존비밀번호';

FLUSH PRIVILEGES;

코멘트

답글 남기기

이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다