WordPress: 데이터베이스 연결 설정 오류

이 오류의 의미와 확인 방법

• 사이트에 “Error establishing a database connection”만 표시되며, 대부분 모든 프런트엔드 페이지에서 발생합니다.
• /wp-admin/도 동일한 데이터베이스 연결을 사용하므로 이용할 수 없습니다.
• 마이그레이션, 호스팅 변경, 데이터베이스 복원, 수동 wp-config.php 수정, 비밀번호 재설정 또는 데이터베이스 서버 재시작 후 오류가 시작될 수 있습니다.
• 일부 페이지만 실패하고 다른 데이터베이스 기반 페이지는 정상적으로 작동한다면, 전체 데이터베이스 연결 실패가 아니라 페이지, 플러그인, 테마 또는 쿼리별 문제일 수 있습니다.

가능성이 높은 순서의 주요 원인

1. wp-config.php의 잘못된 인증 정보 — DB_NAME, DB_USER, DB_PASSWORD 또는 DB_HOST가 현재 데이터베이스 설정과 더 이상 일치하지 않습니다. 마이그레이션, 복원, 비밀번호 변경 또는 수동 수정 후 특히 자주 발생합니다.
2. 사용할 수 없는 MySQL 또는 MariaDB 서버 — 서비스가 중지되었거나 충돌했거나, 호스팅 리소스 문제로 사용할 수 없게 되었을 수 있습니다.
3. 잘못된 데이터베이스 호스트 — 데이터베이스가 다른 서버나 컨테이너에서 실행 중일 때 localhost가 잘못된 값일 수 있습니다. 반대로 원격 호스트 값이 현재 환경과 더 이상 일치하지 않을 수도 있습니다.
4. 누락된 데이터베이스 사용자 권한 — 사용자가 존재하더라도 WordPress 데이터베이스에 할당되지 않았거나 데이터베이스를 사용하는 데 필요한 권한이 없을 수 있습니다.
5. 손상된 데이터베이스 테이블 — 중단된 쓰기 작업, 비정상 종료 또는 디스크 문제로 테이블이 손상될 수 있지만, 일반적으로 설정 또는 가용성 문제보다 가능성이 낮습니다.

해결 방법

1. 장애 범위 확인

공개 사이트와 /wp-admin/을 엽니다. 두 곳 모두 연결 오류를 표시하면 아래 데이터베이스 확인을 계속 진행하세요. 한 페이지 또는 한 기능만 실패한다면 전체 데이터베이스 연결을 사용할 수 없다고 가정하지 말고 해당 플러그인, 테마, 쿼리 또는 애플리케이션 오류를 확인하세요.

2. MySQL 또는 MariaDB 실행 여부 확인

서비스 관리를 직접 담당하는 VPS 또는 전용 서버에서는 관련 서비스 상태를 확인하세요. 다음 명령은 읽기 전용이며 셸 액세스가 필요합니다.

systemctl status mysql

서버에서 MariaDB를 사용한다면 다음을 확인하세요.

systemctl status mariadb

공유 호스팅 또는 관리형 호스팅에서는 호스팅 패널의 데이터베이스 상태 정보를 사용하거나 제공업체에 서비스 및 리소스 한도를 확인해 달라고 요청하세요. 해당 서버를 관리하고 적절한 권한이 있으며 운영에 미칠 영향이 허용 가능한지 확인한 경우에만 데이터베이스 서비스를 재시작하세요. 재시작하면 활성 데이터베이스 연결이 중단될 수 있습니다.

3. wp-config.php의 네 가지 데이터베이스 설정 확인

SFTP 또는 호스팅 파일 관리자를 사용하여 wp-config.php를 엽니다. 다음 값을 호스팅 패널 또는 마이그레이션 기록의 현재 데이터베이스 정보와 비교하세요.

• DB_NAME — WordPress가 사용해야 하는 데이터베이스
• DB_USER — 데이터베이스 사용자 이름
• DB_PASSWORD — 해당 사용자의 현재 비밀번호
• DB_HOST — 데이터베이스 서버 주소 또는 호스트 설정

오래된 데이터베이스 이름, 만료된 비밀번호, 잘못된 호스트 또는 실수로 추가되거나 변경된 공백 및 따옴표를 확인하세요. 마이그레이션, 호스팅 이전, 데이터베이스 복원 또는 비밀번호 재설정 후에도 이전 값이 유효하다고 가정하지 마세요.

4. WordPress 외부에서 동일한 연결 테스트

wp-config.php의 정확한 데이터베이스 이름, 사용자 이름, 비밀번호 및 호스트를 사용하여 phpMyAdmin 또는 MySQL 명령줄에서 테스트하세요. 이 테스트는 WordPress가 사용하는 것과 동일한 환경 및 인증 정보를 사용해야 합니다.

• 직접 연결에 실패하면 WordPress 파일을 변경하기 전에 인증 정보, 데이터베이스 호스트, 서버 가용성 또는 네트워크 액세스를 조사하세요.
• 직접 연결에 성공하면 기본적인 서버 및 인증 정보 경로가 작동하는 것입니다. 데이터베이스 사용자 할당, 권한 및 테이블 상태를 계속 확인하세요.

도움을 요청할 때 비밀번호나 전체 wp-config.php 파일을 절대 게시하지 마세요.

5. 데이터베이스 사용자 액세스 및 권한 확인

호스팅 패널의 데이터베이스 사용자 섹션에서 wp-config.php의 사용자가 올바른 WordPress 데이터베이스에 할당되어 있고 해당 테이블을 읽고 수정할 권한이 있는지 확인하세요. 새 계정으로 데이터베이스를 복원했거나 대체 사용자를 생성한 후에는 이 확인이 특히 중요합니다.

MySQL을 직접 관리한다면 권한이 있는 관리자가 SHOW GRANTS로 계정의 권한을 확인할 수 있습니다. 대상 데이터베이스와 계정을 확인한 후에만 사용자와 데이터베이스의 할당 또는 권한을 수정하세요. 그런 다음 직접 연결 테스트를 반복하고 사이트를 다시 로드하세요.

6. 연결이 작동한 후에만 테이블 문제 확인

데이터베이스 서버를 사용할 수 있고, 직접 테스트에서 정확한 인증 정보가 작동하며, 사용자가 액세스 권한을 보유하고 있다면 phpMyAdmin 또는 권한이 있는 데이터베이스 도구를 통해 WordPress 테이블을 확인하세요. CHECK TABLE로 테이블 문제를 보고할 수 있습니다.

복구를 시도하기 전에 최신 데이터베이스 백업을 생성하거나 백업 상태를 확인하세요. REPAIR TABLE은 주로 지원되는 MyISAM 테이블과 관련된 명령이며 만능 복구 방법이 아닙니다. 확인 결과 손상이 보고되지 않았는데 복구 명령을 반복해서 실행하지 마세요. 추가 진단을 위해 호스트, 설정, 권한 및 서버 로그를 다시 확인하세요.

7. 수정 후 전체 사이트 확인

여러 공개 페이지와 /wp-admin/을 로드하세요. 두 곳이 모두 작동한다면 오래된 출력이 남아 있을 때만 관련 캐시 계층을 삭제하세요. 어느 한 영역이라도 계속 실패한다면 현재 표시되는 정확한 메시지를 기록하고, 원래의 연결 문제가 그대로라고 가정하지 말고 서버 또는 호스팅 로그를 검토하세요.

예방 및 해결 확인 방법

• 현재 데이터베이스 이름, 사용자, 호스트 및 비밀번호 정보를 보호된 비밀번호 관리자 또는 이에 준하는 안전한 기록에 보관하세요.
• 모든 마이그레이션 또는 호스팅 변경 후 이전을 완료하기 전에 공개 사이트와 /wp-admin/을 모두 테스트하세요.
• 정기적인 데이터베이스 백업을 유지하고 주기적으로 복원이 가능한지 확인하세요.
• 각 WordPress 데이터베이스에 어떤 데이터베이스 사용자가 할당되어 있는지 기록하여 복원 또는 사용자 교체로 액세스 권한이 조용히 사라지지 않도록 하세요.
• 사용 가능한 경우 호스팅 리소스 알림과 데이터베이스 서비스 이벤트를 검토하세요. 특히 예기치 않은 재시작 또는 반복적인 연결 실패 후에는 반드시 확인해야 합니다.
• wp-config.php에 대한 액세스를 제한하고 지원 요청에서 해당 내용이나 인증 정보를 공유하지 마세요.

자주 묻는 질문