DEV WIKI
백엔드 · 오류·증상

Error Establishing Database Connection

오류 메시지·상태명

최종 검토
2026-07-24
참고 자료
있음

빠른 답변

이 오류는 무엇인가요?
WordPress 페이지에 데이터베이스 연결 오류 메시지가 표시될 때 `wp-config.php`의 데이터베이스 설정과 호스팅 상태를 확인합니다.
가장 흔한 원인은 무엇인가요?
WordPress에서 “Error Establishing Database Connection”이 표시되면 `wp-config.php`의 데이터베이스 이름, 사용자 이름, 비밀번호, 호스트를 확인하고 호스팅 제공업체에 데이터베이스 할당량 또는 서버 중단 여부를 확인합니다.
무엇을 먼저 확인해야 하나요?
FTP 클라이언트로 사이트에 접근해 `wp-config.php`를 열고 데이터베이스 이름, 사용자 이름, 비밀번호, 데이터베이스 호스트가 올바른지 확인합니다.

현재 증상

  • 데이터베이스 연결 실패

먼저 확인할 항목

FTP 클라이언트로 사이트에 접근해 `wp-config.php`를 열고 데이터베이스 이름, 사용자 이름, 비밀번호, 데이터베이스 호스트가 올바른지 확인합니다.

호스팅 제공업체에 데이터베이스 할당량 도달로 데이터베이스가 중단되었는지 또는 서버가 중단되었는지 문의합니다.

피해야 할 조치

주의

  • 설정을 변경해야 하는 경우에는 변경 전 현재 값과 변경 대상을 기록하고, 가능한 경우 백업 또는 내보내기를 수행합니다.
  • 한 번에 한 항목만 변경하고, 장애나 오류가 발생하면 기록한 이전 값으로 복구합니다.

환경별 원인과 조치

증상

WordPress 페이지에 “Error Establishing Database Connection” 메시지가 표시됩니다.

확인

  1. FTP 클라이언트로 사이트에 접근해 wp-config.php를 엽니다.
  2. 데이터베이스 이름, 사용자 이름, 비밀번호, 데이터베이스 호스트가 올바른지 확인합니다.
  3. 호스팅 제공업체에 데이터베이스 할당량 도달로 데이터베이스가 중단되었는지 또는 서버가 중단되었는지 문의합니다.

판정 기준

  • wp-config.php의 데이터베이스 이름, 사용자 이름, 비밀번호, 데이터베이스 호스트가 올바르게 설정되어 있어야 합니다.
  • 호스팅 제공업체가 데이터베이스 할당량 도달 또는 서버 중단 여부를 확인해야 합니다.

주의사항

  • 이 문서는 wp-config.php 값 확인과 호스팅 상태 문의만 다룹니다.
  • 설정을 변경해야 하는 경우에는 변경 전 현재 값과 변경 대상을 기록하고, 가능한 경우 백업 또는 내보내기를 수행합니다.
  • 한 번에 한 항목만 변경하고, 장애나 오류가 발생하면 기록한 이전 값으로 복구합니다.

참고 자료

WordPress · 공식 자료 (새 창에서 열림)

확인 범위: “Error Establishing Database Connection” 메시지가 표시되면 데이터베이스 연결에 문제가 있음을 의미합니다., “Error establishing a database connection”은 보통 `wp-config.php` 파일의 오류로 발생합니다., `wp-config.php`에서 데이터베이스 이름, 사용자 이름, 비밀번호, 데이터베이스 호스트가 올바른지 확인할 수 있습니다., 데이터베이스 할당량 도달로 데이터베이스가 중단되었거나 서버가 중단된 호스팅 문제가 원인일 수 있습니다. · 확인일: 2026-07-24