워드프레스 '데이터베이스 연결 중 오류' 해결 방법

워드프레스에서 '데이터베이스 연결 중 오류 (Error establishing a database connection)'가 발생하는 경우가 있습니다. 이 오류는 DB 정보가 잘못되는 경우에 주로 발생하며 이외에도 서버 리소스 부족 등 다른 원인으로도 이 오류가 발생될 수 있습니다.

워드프레스 '데이터베이스 연결 중 오류' 해결 방법

DB 정보 오류

이 오류는 데이터베이스 정보가 잘못 입력되어 발생하는 경우가 많습니다. 워드프레스를 새로 설치하거나 워드프레스 사이트를 이전(마이그레이션)한 후에 '데이터베이스 연결 줄 오류'가 발생한다면 먼저 wp-config.php 파일에서 DB 정보를 확인하여 잘못 입력되지 않았는지 체크해 보시기 바랍니다.

FTP를 통해 웹서버에 접속하여 wp-config.php 파일에서 먼저 DB 이름과 사용자명 및 비밀번호가 잘못되지 않았는지 확인해보세요.

define( 'DB_NAME', 'database_name_here' );

/** Database username */
define( 'DB_USER', 'username_here' );

/** Database password */
define( 'DB_PASSWORD', 'password_here' );

/** Database hostname */
define( 'DB_HOST', 'localhost' );

요즘은 워드프레스가 자동으로 설치되는 경우가 많아서 DB 정보가 잘못되는 경우는 드뭅니다. 다음의 경우에는 DB 이름과 DB 사용자명, DB 패스워드가 잘못될 수 있습니다.

1. 직접 DB를 생성하여 워드프레스를 설치하는 경우
2. 사이트를 이전하는 경우

예를 들어, 카페24나 케미클라우드, 클라우드웨이즈 등에서 워드프레스를 자동으로 설치하면 DB 정보가 자동으로 wp-config.php 파일에 입력되므로 문제가 발생하지 않습니다.

데이터베이스 호스트명(Database hostname)은 일반적으로 "localhost"이지만, 일부 웹호스팅에서는 다를 수 있습니다. 예를 들어, 가비아의 경우 DB hostname에  DB 서버의 IP 주소를 입력하기도 합니다.

DB 테이블 접두사(프리픽스) 불일치

wp-config.php 파일에서 테이블 접두사와 실제 DB 접두사가 일치하지 않는 경우에도 이 오류가 발생합니다. wp-config.php 파일에서 $table_prefix 값이 정확한지 실제 DB를 체크하여 확인해 보시기 바랍니다.

$table_prefix = 'wp_';

카페24, 클라우드웨이즈 등 많은 호스팅에서 워드프레스 설치 시 기본 테이블 프리픽스가 wp_이지만 케미클라우드, 패스트코멧 등 cPanel을 제공하는 호스팅 환경에서는 wp_ 대신 다른 DB 테이블 접두사가 사용됩니다.

DB 서버 다운

DB 서버가 다운되는 경우에도 이 오류가 발생합니다. 웹호스팅 업체에 연락하여 문의하여 서버에 에러가 없는지 확인할 수 있습니다.

서버를 직접 관리하는 경우에는 서버 관리 도구에서 DB 서버 상태를 확인하고 재시작하여 문제가 해결되는지 확인합니다.

데이터베이스 테이블 또는 데이터 손상

워드프레스 DB 테이블이 깨지거나 손상되는 경우가 있을 수 있습니다. phpMyAdmin이 제공되는 환경인 경우 phpMyAdmin에 접속하여 DB 테이블 복구를 시도할 수 있습니다.

다른 방법으로 백업본이 있다면 백업본으로 DB를 복구하는 것도 고려할 수 있습니다.

서버 리소스 문제 또는 사이트 최적화 문제

서버 리소스가 부족하거나 방문자 수가 증가하면서 서버가 감당하지 못하는 경우에도 이 문제가 발생할 수 있습니다. 또한, 사이트 최적화가 제대로 안 되어 트래픽이 증가하거나, 특정 플러그인이나 코드 문제로 인해 서버 리소스가 급속하게 소진되는 경우에도 이 문제가 발생할 수 있습니다.

사이트 최적화를 시도해 보고, 서버 리소스가 부족한 경우에는 서버 리소스를 증설하는 것을 고려할 수 있습니다. 클라우드웨이즈를 이용하는 경우 방문자 수가 증가하여 이런 문제가 발생한다면 서버 크기를 업그레이드할 수 있습니다.

마치며

워드프레스 사이트에서 '데이터베이스 연결 중 오류'가 발생하면 먼저 DB 정보가 잘못 입력되지 않았는지 확인하고, DB 정보에 이상이 없다면 사이트 최적화 문제이거나 서버 문제일 수 있으므로 웹호스팅 업체에 연락하여 원인을 문의해 볼 수 있습니다. 가끔 일시적으로 서버 리소스가 부족해지면서 이런 문제가 발생하기도 합니다. 그런 경우 잠시 기다리면 해결되기도 합니다.

👉 웹호스팅 또는 워드프레스 관련 문제로 해결에 어려움을 겪는 경우 여기에서 서비스(유료)를 의뢰하실 수 있습니다.

참고

https://avada.tistory.com/3758

Vultr 헤스티아 패널(hestiaCP) 워드프레스의 500 Internal Server Error 문제 해결

 

https://avada.tistory.com/3686

클라우드웨이즈: 의심스러운 활동 감지로 인한 계정 비활성화 문제