서버를 옮긴 뒤 데이터베이스 연결이 되지 않아요
서버 이전 뒤 DB 연결 실패를 접속 대상·자격 증명·권한·연결 수·네트워크 변경으로 나눠 확인하는 가이드입니다.
빠른 답변
서버 이전 뒤 DB 연결이 안 되면 이전·현재 호스트·포트·소켓·DB 이름·실행 환경을 비교하고 오류 번호에 따라 자격 증명·권한·네트워크·연결 수를 분리해야 합니다. 운영 DB를 추측으로 수정하거나 같은 작업을 반복하지 않습니다.
- 적용 범위
- 이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
- 출처
- MySQL
- 출처 확인일
- 2026-07-27
- 최종 검토
- 2026-08-05
- 수정일
- 2026-08-05
- 정정 이력
- 2026-07-29 이후 기록 없음
- 대상
- 사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
이 가이드가 맞는 경우
- 애플리케이션 오류 메시지
- 데이터베이스 연결 실패
상황별 다음 단계
The error (2002) Can't connect to ...
화면, 로그 또는 관리자 도구에서 The error (2002) Can't connect to ...과 일치하는 문구·상태가 확인됩니다.
Can't connect to MySQL server on '%s:%u' (%d)
화면, 로그 또는 관리자 도구에서 Can't connect to MySQL server on '%s:%u' (%d)과 일치하는 문구·상태가 확인됩니다.
Access denied for user '%s'@'%s' (using password: YES)
MySQL 오류 1045 형식으로 사용자 인증이 거부되고 사용자·호스트가 표시됩니다.
MySQL 연결 수가 max_connections에 도달함
MySQL 오류 1040과 Too many connections가 표시되고 연결 수 제한에 도달했습니다.
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 문제가 발생한 URL, 화면 또는 로그의 원문, 최초 발생 시각을 전달합니다.
- 비밀번호, 인증 토큰, 세션 쿠키, 결제 정보, 개인정보는 전달하지 않습니다.
- 최근 배포, 설정, 도메인, 플러그인 또는 인프라 변경이 있었다면 시각과 변경 범위를 함께 전달합니다.
알아둘 점
“서버 이전 후 DB 연결 안 됨”, “호스팅 이전 후 데이터베이스 오류”로 검색하는 상황에서 사용합니다. 이전 서버와 현재 서버의 연결 대상과 실행 환경을 먼저 비교합니다.
먼저 기록할 것
- 이전·현재 DB 호스트·포트·소켓·DB 이름·애플리케이션 실행 환경을 기록합니다.
- 오류 번호·메시지·발생 URL·최초 실패 시각을 기록합니다.
- DB 서버 실행 상태·방화벽·접속 계정의 호스트 권한·연결 수 제한을 각각 확인합니다.
- 비밀번호·접속 문자열·고객 데이터는 전달하지 않고, 이전·현재 설정의 차이만 기록합니다.
상황별 다음 단계
| 관찰값 | 다음 문서 |
|---|---|
오류 2002 Can't connect to ... | MySQL 오류 2002 연결 실패 |
| 호스트·포트 연결 실패 | MySQL 서버 호스트·포트 연결 실패 |
| 오류 1045로 사용자 인증 거부 | MySQL 사용자 접근 거부 |
오류 1040 Too many connections | MySQL 연결 수 초과 |
수정 후 재확인
- 애플리케이션과 같은 실행 환경에서 새 DB로 연결을 다시 확인합니다.
- 읽기·쓰기·마이그레이션 상태를 각각 확인하고 운영 데이터 변경은 별도 승인 없이 실행하지 않습니다.
- 연결이 한 번 성공해도 재시작·부하·여러 애플리케이션 인스턴스에서 반복 확인합니다.
참고 자료
MySQL · 공식 자료 · 확인 범위: MySQL 공식 문서는 오류 2002가 MySQL 서버 미실행 또는 잘못된 Unix socket 파일 이름이나 TCP/IP 포트 번호를 일반적인 의미로 설명합니다., MySQL 공식 문서는 사용 중인 TCP/IP 포트가 방화벽 또는 포트 차단 서비스에 의해 차단되지 않았는지 확인하도록 안내합니다., MySQL 공식 문서는 mysqld 프로세스 실행 상태와 socket 파일 또는 포트 설정을 확인한 뒤 같은 연결을 재시도하도록 안내합니다. · 확인일: 2026-07-27
MySQL · 공식 자료 · 확인 범위: MySQL 클라이언트 오류 번호 2003의 기호는 CR_CONN_HOST_ERROR입니다., 오류 번호 2003의 메시지는 `Can't connect to MySQL server on '%s:%u' (%d)`입니다. · 확인일: 2026-07-24