WordPress에서 데이터베이스 연결 오류가 보여요
WordPress DB 연결 오류를 자격 증명·DB 서버 상태·유지보수 화면으로 구분해 확인하는 가이드입니다.
빠른 답변
WordPress DB 오류가 보이면 정확한 원문·발생 범위·최근 변경을 기록하고, wp-config.php 연결 정보·DB 서버 응답·유지보수 상태를 분리해 확인해야 합니다. 자격 증명이나 운영 DB를 추측으로 수정하지 않습니다.
- 적용 범위
- 이 가이드의 시작 증상과 각 분기 조건이 일치하는 경우
- 출처 확인일
- 2026-07-26
- 최종 검토
- 2026-08-05
- 수정일
- 2026-08-05
- 정정 이력
- 2026-07-29 이후 기록 없음
- 대상
- 사이트 운영자, 쇼핑몰 운영자, 웹 에이전시, 프리랜서
이 가이드가 맞는 경우
- 애플리케이션 오류 메시지
- 데이터베이스 연결 실패
상황별 다음 단계
There has been a critical error on this website. Please check your site admin email inbox for instructions.
화면, 로그 또는 관리자 도구에서 There has been a critical error on this website. Please check your site admin email inbox for instructions.과 일치하는 문구·상태가 확인됩니다.
Error establishing a database connection
화면, 로그 또는 관리자 도구에서 Error establishing a database connection과 일치하는 문구·상태가 확인됩니다.
Briefly unavailable for scheduled maintenance. Please check back in a minute.
화면, 로그 또는 관리자 도구에서 Briefly unavailable for scheduled maintenance. Please check back in a minute.과 일치하는 문구·상태가 확인됩니다.
호스팅사·개발자에게 전달할 내용
변경 전 기록
- 문제가 발생한 URL, 화면 또는 로그의 원문, 최초 발생 시각을 전달합니다.
- 비밀번호, 인증 토큰, 세션 쿠키, 결제 정보, 개인정보는 전달하지 않습니다.
- 최근 배포, 설정, 도메인, 플러그인 또는 인프라 변경이 있었다면 시각과 변경 범위를 함께 전달합니다.
알아둘 점
“워드프레스 DB 연결 안 됨”, “Error Establishing a Database Connection”으로 검색하는 상황에서 사용합니다. WordPress 치명적 오류·유지보수 화면은 DB 연결 오류와 분리합니다.
먼저 기록할 것
- 오류 URL·화면의 원문·HTTP 상태·발생 시각과 전체 사이트인지 특정 기능인지 기록합니다.
wp-config.php의 DB 이름·호스트·사용자 설정이 배포 환경과 일치하는지 비밀값을 노출하지 않고 비교합니다.- DB 서버·호스팅 상태, 애플리케이션 로그, 최근 플러그인·DB·서버 변경을 기록합니다.
- 유지보수 화면이나 치명적 오류 화면이면 DB 연결 오류로 단정하지 않습니다.
상황별 다음 단계
| 관찰값 | 다음 문서 |
|---|---|
Error Establishing a Database Connection | WordPress 데이터베이스 연결 오류 |
There has been a critical error on this website | WordPress 치명적 오류 메시지 |
Briefly unavailable for scheduled maintenance | WordPress 예약 유지보수 화면 |
수정 후 재확인
- DB 연결 확인 뒤 공개 페이지·
wp-admin·주요 읽기 기능을 각각 확인합니다. - DB 자격 증명·스키마·데이터 변경 후에는 로그와 백업 상태를 먼저 확인합니다.
- 정상 응답이 한 번 나온 것만으로 간헐적인 DB 중단이 해결됐다고 단정하지 않습니다.
참고 자료
WordPress · 공식 자료 · 확인 범위: 이 메시지는 사이트의 어떤 항목이 WordPress의 정상 실행을 막는 치명적 오류를 일으켰음을 나타냅니다., WordPress가 오류 세부 정보를 사이트 관리자 이메일로 보냈는지 확인하도록 안내합니다., 원문은 플러그인 충돌, 테마 호환성 문제, 호환되지 않는 PHP 버전, 메모리 한도 도달, 손상된 WordPress 파일을 확인할 수 있는 일반적인 원인으로 제시합니다. · 확인일: 2026-07-24
확인 범위: 로컬 MAMP 환경에서 로그인과 첫 화면에 치명적 오류가 발생했습니다., 디버그 로그에 누락된 WordPress Core 파일과 PHP fatal error가 기록됐습니다., WordPress Core를 수동 재설치한 뒤 사이트가 정상 복구됐다고 보고됐습니다. · 확인일: 2026-07-26
확인 범위: WooCommerce 주문 화면에서 한 관리자 계정에 치명적 오류가 발생했습니다., 플러그인 재설치와 다른 플러그인 시험은 문제를 해결하지 못했습니다., 호스팅 제공자가 메모리를 늘린 뒤 두 관리자 계정이 정상 동작했습니다. · 확인일: 2026-07-26
확인 범위: 오래된 WordPress 사이트에서 여러 브라우저와 기기의 관리자 로그인 시 같은 치명적 오류가 발생했습니다., PHP 8 이상과의 호환성 문제가 확인됐습니다., PHP 7.4로 되돌린 뒤 wp-admin 접근이 복구됐습니다. · 확인일: 2026-07-26
확인 범위: definition, common-causes, resolution · 확인일: 2026-07-23
확인 범위: WooCommerce 업데이트 뒤 데이터베이스 연결 오류가 표시되었습니다., DB 자격 증명, DB 서버 상태, DB 손상이 점검 대상으로 제시되었습니다., wp-config.php 설정 확인, 호스팅 상태 확인, DB 복구가 안내되었습니다. · 확인일: 2026-07-26
확인 범위: 장기간 운영한 WooCommerce VPS 사이트에서 데이터베이스 연결 오류가 주기적으로 발생했습니다., 약 800MB 데이터베이스와 바쁜 쿼리가 있는 환경에서 DB 중단이 관찰되었습니다., 호스팅사의 DB 복구 뒤 사이트가 다시 동작했습니다., DB 최적화, 플러그인 점검, 캐시, 호스팅 상향이 제시되었습니다. · 확인일: 2026-07-26
확인 범위: WooCommerce Analytics, 장바구니, 로그인에서 약 10분간 데이터베이스 연결 실패가 발생했습니다., 플러그인 충돌과 DB 서버 무응답이 점검 대상으로 제시되었습니다., WooCommerce 외 플러그인 비활성화로 재현 여부를 확인하고, 지속 시 호스팅사에 서버 로그와 DB 실행 상태 점검을 요청하도록 안내되었습니다. · 확인일: 2026-07-26