Error establishing a database connection

핵심 답변

"Error establishing a database connection"은 WordPress가 데이터베이스 서버에 연결하지 못해 페이지를 생성할 수 없다는 뜻입니다. wp-config.php의 데이터베이스 이름·사용자·비밀번호·호스트 값이 맞는지, 데이터베이스 서버가 정상인지, 호스팅 계정의 용량 한도나 서버 다운이 없는지 순서대로 확인해야 합니다.

상세 설명

현재 증상

• 데이터베이스 연결 실패

확인 순서

1. wp-config.php의 DB_NAME·DB_USER·DB_PASSWORD·DB_HOST 값이 실제 데이터베이스 설정과 일치하는지 확인합니다.
2. 웹 호스트에 데이터베이스 용량 한도 초과나 데이터베이스 서버 다운이 없는지 확인합니다.
3. 설정과 호스팅에 이상이 없으면 사이트가 외부 침해로 변조되지 않았는지 점검합니다.
4. 수정 후 같은 URL을 다시 열어 오류 화면이 재현되는지 확인합니다.

주의할 조치

• wp-config.php를 수정하기 전에 원본 파일을 백업해 잘못된 값으로 덮어썼을 때 되돌릴 수 있게 합니다.
• MySQL 비밀번호를 재설정하는 경우 wp-config.php의 값도 함께 바꿔야 하며, 다른 애플리케이션이 같은 계정을 쓰는지 먼저 확인합니다.
• 이 오류 화면만으로 데이터가 손실됐다고 단정하지 않습니다. 연결 실패는 데이터 삭제와 다른 상태입니다.

서버 오류 원인 구간 확인

서버 오류가 발생하면 먼저 응답 코드와 오류 로그로 서버 측 문제임을 확인하고, 애플리케이션 코드·구성 파일·플러그인·데이터베이스·메모리를 하나씩 분리해 원인 구간을 좁혀야 합니다. 한 부분만 바꾼 뒤 재현 여부를 확인해 인과를 확정합니다.

• 반환된 상태 코드가 5xx인지 확인합니다. 통과 기준은 500 등 서버 오류 응답이 관찰되어 클라이언트가 아닌 서버 측 문제로 좁혀지는 것입니다.
• 서버·애플리케이션 오류 로그(예 debug.log, 서버 error log)에 해당 시각의 오류가 기록됐는지 확인합니다. 통과 기준은 요청 시각과 일치하는 오류 항목을 찾아내는 것입니다.
• 최근 변경분(코드·구성 파일·플러그인·테마)을 되돌리거나 비활성화한 뒤 재현되는지 확인합니다. 통과 기준은 한 번에 한 요소만 바꿔 원인 요소를 특정하는 것입니다.
• 데이터베이스 연결과 애플리케이션 실행(메모리·실행 시간)을 각각 분리해 확인합니다. 통과 기준은 DB 연결 실패와 실행 자원 부족 중 어느 구간인지 구분되는 것입니다.
• 원인으로 지목한 구간만 수정한 뒤 동일 URL을 다시 요청해 5xx가 사라졌는지 확인합니다. 통과 기준은 반복 요청에서 오류가 재현되지 않는 것입니다.

근거와 출처