워드프레스 웹사이트를 운영하다 보면 가끔 “Error establishing a database connection“이라는 오류 문구가 나타날 수 있습니다.
이 오류는 웹사이트에 심각한 문제가 발생했다는 것을 의미하며, 방문자는 웹사이트에 접속할 수 없게 됩니다. 이 글에서는 해당 오류의 원인과 해결 방법을 자세히 알아보겠습니다.
워드프레스 데이터베이스 연결 오류의 원인
1. 데이터베이스 자격 증명 오류
워드프레스는 웹사이트를 로드할 때 데이터베이스에서 정보를 가져옵니다.
이때 사용되는 데이터베이스 이름, 사용자 이름, 비밀번호, 호스트 이름이 정확하지 않다면 데이터베이스에 연결할 수 없습니다. 이러한 자격 증명이 잘못되어 있으면 “Error establishing a database connection” 오류가 발생합니다.
2. 워드프레스 파일의 손상
워드프레스의 핵심 파일이 손상되면 데이터베이스와의 연결에 문제가 생길 수 있으며 이는 잘못된 플러그인 설치, 테마 문제, 또는 악성 코드로 인해 발생할 수 있습니다.
우선 실행 중인 플러그인을 모두 비활성화하거나 삭제하느것을 추천하며 워드프레스 접속 및 로그인이 불가능하다면 FTP를 통해 접속해야 합니다.
참고 : 맥북 FTP 접속 – 파일질라 다운로드 및 로그인 워드프레스 설치
3. 데이터베이스 손상
데이터베이스 자체가 손상된 경우에도 해당 오류가 발생할 수 있습니다. 이는 서버 문제, 불안정한 연결, 또는 잘못된 SQL 쿼리로 인해 발생할 수 있습니다.
4. 서버 문제
서버가 다운되었거나 과부하 상태일 때, 데이터베이스 연결 오류가 발생할 수 있습니다. 특히 공유 호스팅 환경에서는 트래픽 급증이 데이터베이스 서버에 과부하를 일으킬 수 있습니다.
저 같은 경우 가장 저렴한 카페24 호스팅을 사용할 때 서버문제 트래픽 부족등이 자주 발생했고 블루호스트의 베이직 요금제를 쓸 때에도 무제한 요금제라고 하지만 트래픽이 조금만 늘어나면 금방 과부하가 걸리곤 했습니다.
데이터베이스 연결 오류 해결 방법
1. 데이터베이스 자격 증명 확인
가장 먼저 해야 할 일은 wp-config.php
파일에 저장된 데이터베이스 자격 증명을 확인하는 것입니다. 이 파일은 워드프레스 설치 디렉토리에 있으며, FTP 클라이언트를 통해 접근할 수 있습니다.
다음과 같은 코드 부분을 확인합니다:
// MySQL 설정
define( 'DB_NAME', 'database_name_here' ); // 데이터베이스 이름
define( 'DB_USER', 'username_here' ); // MySQL 사용자 이름
define( 'DB_PASSWORD', 'password_here' ); // MySQL 비밀번호
define( 'DB_HOST', 'localhost' ); // MySQL 호스트 이름
여기서 DB_NAME
, DB_USER
, DB_PASSWORD
, DB_HOST
의 값이 올바른지 확인한 후, 잘못된 정보가 있다면 수정하고 저장합니다. 수정 후 웹사이트를 새로고침하여 오류가 해결되었는지 확인합니다.
2. 데이터베이스 복구
데이터베이스가 손상된 경우, wp-config.php
파일에 다음 코드를 추가하여 데이터베이스를 복구할 수 있습니다.
define('WP_ALLOW_REPAIR', true);
그 후 웹 브라우저에서 http://Domain.com/wp-admin/maint/repair.php
에 접속하여 “Repair Database” 또는 “Repair and Optimize Database” 버튼을 클릭합니다. 복구가 완료되면, 위의 코드를 다시 삭제합니다.
3. 서버 상태 확인
서버가 응답하지 않거나 다운되었을 경우, 데이터베이스 연결 오류가 발생할 수 있습니다.
이럴 때는 호스팅 제공업체에 문의하여 서버 상태를 확인합니다. 서버가 과부하 상태라면 트래픽을 분산하거나 서버 자원을 확장하는 방법을 고려할 수 있습니다.
4. 백업 복원
이전 백업을 통해 문제가 발생하기 전 상태로 웹사이트를 복원하는 것도 하나의 방법으로 카페24의 경우 기본적으로 7일간의 DB가 자동으로 백업되기 때문에 이를 통해 복구하느것이 좋습니다.
참고 : 워드프레스 백업 DB 초기화 – 데이터 재설치
이상 워드프레스를 관리하면서 데이터베이스 오류 “Error establishing a database connection” 오류는 다양한 원인에 의해 발생할 수 있지만, 올바른 접근 방법을 통해 대부분의 문제를 해결할 수 있습니다. 데이터베이스 자격 증명 확인, 데이터베이스 복구, 서버 상태 점검 등을 통해 문제를 해결하고, 향후 이러한 오류가 발생하지 않도록 대비하는 것이 중요합니다.