MySQL 연결 오류 때문에 서비스가 열리지 않아요
애플리케이션 로그에 MySQL 연결 거부, 접속 실패 또는 데이터베이스 이름 오류가 표시될 때 원문 메시지로 확인 문서를 고릅니다.
빠른 답변
MySQL 연결 오류가 발생하면 접속 정보나 권한을 바로 바꾸지 말고 오류 번호, 대상 호스트·포트, 데이터베이스 이름을 기록한 뒤 같은 오류 문구를 다루는 문서를 확인해야 합니다.
이 가이드가 맞는 경우
- 데이터베이스 연결 실패
- 애플리케이션 오류 메시지
상황별 다음 단계
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 오류 번호와 메시지, 대상 호스트·포트, 데이터베이스 이름을 전달합니다.
- 오류가 난 애플리케이션 URL과 발생 시각을 전달합니다.
- 비밀번호·접속 문자열 원문은 전달하지 않고 사용한 계정 이름만 전달합니다.
알아둘 점
MySQL 연결 오류는 호스트·포트, 데이터베이스 이름, 계정, 네트워크 조건을 구분해야 합니다. 오류 번호와 메시지를 기록하고 위에서 같은 문구를 선택하세요.
먼저 기록할 것
- 로그의 MySQL 오류 번호와 메시지 전체를 기록합니다.
- 대상 호스트, 포트, 데이터베이스 이름을 기록합니다.
- 최근 호스팅, 데이터베이스, 네트워크 변경이 있었는지 기록합니다.
접속 문자열이나 비밀번호를 로그·채팅·스크린샷에 남기지 마세요. 오류 메시지가 다른 경우에는 같은 원문 메시지를 검색해 해당 Problem 문서를 확인하세요.
참고 자료
Can't connect to [local] MySQL server | MySQL 8.0 Reference Manual (새 창에서 열림)
MySQL · 공식 자료 · 확인 범위: guide-branch-mysql-connection-errors · 확인일: 2026-07-27