MySQL 8로 올린 뒤 기존 사이트가 연결되지 않아요

MySQL 서버를 업그레이드한 뒤 기존 PHP 사이트의 계정·인증 방식·서버 연결이 달라졌을 때 확인하는 시작 Guide입니다. 오류 원문과 발생 환경이 일치하지 않으면 원인을 단정하지 않습니다.

먼저 기록할 것

1. 화면·브라우저 개발자 도구·서버 로그 중 어디에서 오류를 확인했는지 기록합니다.
2. 오류 문구·상태 코드·요청 주소·발생 시각을 가능한 한 원문 그대로 보존합니다.
3. 최근 배포·설정·도메인·플러그인·호스팅 변경 여부를 기록합니다.
4. 문의 자료에서는 비밀번호·토큰·쿠키·고객 정보·결제 정보를 제거합니다.

상황별 다음 단계

1. 5.7보다 이른 MySQL 서버에서 8.0 업그레이드가 거부됨이면 Cannot upgrade server earlier than 5.7 to 8.0 문서를 확인합니다.
2. MySQL 서버 업그레이드 작업이 실패함이면 Failed to upgrade server. 문서를 확인합니다.
3. 업그레이드 후 데이터베이스 사용자 인증이 거부됨이면 Access denied for user '%s'@'%s' (using password: YES) 문서를 확인합니다.

확인 순서

1. 문제를 재현하는 URL 또는 기능을 한 가지로 고정합니다.
2. 위 Problem의 관찰값과 현재 화면·로그가 일치하는지 비교합니다.
3. 한 번에 하나의 설정이나 코드만 확인하고, 변경 전 값을 보관합니다.
4. 수정 후 같은 브라우저·주소·기능에서 다시 확인합니다.

MySQL 마이그레이션 판정

관찰값	판정 기준	다음 확인
5.7 이전 버전에서 8.0으로 바로 변경 시도	지원되지 않는 업그레이드 경로 또는 사전 조건 부족을 확인해야 합니다.	현재 버전과 공식 지원 경로를 확인합니다.
업그레이드 중 중단·실패	데이터 사전·시스템 테이블·플러그인 호환성과 오류 로그를 확인합니다.	실패 시각의 로그와 변경된 단계만 비교합니다.
업그레이드 후 접속 거부	계정 인증 방식·권한·호스트 조건이 이전과 달라졌을 수 있습니다.	계정 정의와 애플리케이션 드라이버를 비교합니다.

운영 데이터베이스에서 즉시 재시도하거나 원본을 덮어쓰지 않습니다. 백업 복구가 확인된 테스트 환경에서 버전·스키마·애플리케이션 연결을 순서대로 검증합니다.

수정 후 재확인

1. 현재·목표 MySQL 버전과 공식 지원 업그레이드 경로를 기록합니다.
2. 테스트 복구 후 스키마 검사와 애플리케이션 읽기·쓰기 요청을 확인합니다.
3. 사용자 인증·권한·연결 풀·예약 작업을 각각 점검합니다.
4. 운영 전환 뒤 오류 로그와 성능·연결 수를 일정 시간 관찰합니다.

관련 점검표: MySQL 연결·업그레이드 운영 확인표

오진하지 않기

이 Guide의 제목이나 플랫폼 이름만으로 원인을 확정하지 않습니다. Problem 문서의 조건과 실제 관찰값이 다르면 설정을 변경하지 말고 오류 원문과 환경을 다시 기록합니다.