MySQL 연결 오류 때문에 서비스가 열리지 않아요
MySQL 연결 오류를 소켓·호스트·포트·데이터베이스 이름 문제로 구분해 확인하는 가이드입니다.
빠른 답변
MySQL 연결 오류가 발생하면 오류 번호·대상 호스트·포트·소켓·데이터베이스 이름을 기록하고 서버 실행 상태와 네트워크·권한을 분리해 확인해야 합니다. 접속 정보나 권한을 추측으로 바꾸지 않습니다.
- 적용 범위
- 이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
- 출처
- MySQL
- 출처 확인일
- 2026-07-27
- 최종 검토
- 2026-08-05
- 수정일
- 2026-08-05
- 정정 이력
- 2026-07-29 이후 기록 없음
- 대상
- 사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
이 가이드가 맞는 경우
- 데이터베이스 연결 실패
- 애플리케이션 오류 메시지
상황별 다음 단계
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 오류 번호와 메시지, 대상 호스트·포트, 데이터베이스 이름을 전달합니다.
- 오류가 난 애플리케이션 URL과 발생 시각을 전달합니다.
- 비밀번호·접속 문자열 원문은 전달하지 않고 사용한 계정 이름만 전달합니다.
알아둘 점
“MySQL 서버 연결 실패”, “PHP MySQL 접속 오류”로 검색하는 상황에서 사용합니다. 소켓·호스트·포트·데이터베이스 이름·계정 권한은 서로 다른 확인 대상입니다.
먼저 기록할 것
- 로그의 MySQL 오류 번호·메시지 전체·발생 시각을 기록합니다.
- 대상 호스트·포트·소켓·데이터베이스 이름과 애플리케이션 실행 환경을 기록합니다.
- MySQL 서버 실행 상태·포트 수신·방화벽·계정 호스트 권한을 각각 확인합니다.
- 최근 호스팅·DB·네트워크·환경변수 변경을 기록하고 비밀번호·접속 문자열은 남기지 않습니다.
| 관찰값 | 다음 문서 |
|---|---|
오류 2002 Can't connect to ... | MySQL 오류 2002 연결 실패 |
| 특정 호스트·포트로 연결할 수 없음 | MySQL 서버 호스트·포트 연결 실패 |
Unknown database | MySQL 데이터베이스를 찾을 수 없음 |
수정 후 재확인
- 애플리케이션과 같은 실행 환경에서 같은 호스트·포트로 연결을 다시 확인합니다.
- 정상 연결 뒤 읽기 기능과 쓰기 기능을 각각 확인하고, 운영 데이터 변경은 별도 승인 없이 실행하지 않습니다.
- 접속 문자열·비밀번호·토큰은 로그·채팅·스크린샷에 남기지 않습니다.
참고 자료
Can't connect to [local] MySQL server | MySQL 8.0 Reference Manual (새 창에서 열림)
MySQL · 공식 자료 · 확인 범위: guide-branch-mysql-connection-errors · 확인일: 2026-07-27