워드프레스 데이터베이스 연결 오류 해결하기

워드프레스 웹사이트에 "Error establishing a database connection"라고 에러 문구가 뜨면서 웹사이트에 접속할 수 없다면 그 원인은 무엇일까?

 

위의 오류는 워드프레스가 데이터베이스에 연결할 수 없을 때 발생하는 에러이다. 데이터베이스의 정보가 잘못되었거나, 나, 또는 손상되었거나, 서버가 응답하지 않을 때 발생할 수 있다.

 

워드프레스의 데이터베이스란?

워드프레스의 데이터베이스는 쉽게 말해 모든 웹사이트의 데이터가 저장되는 곳이라고 할 수 있다. 사용자의 이름과 및 비밀번호와 같은 기본적인 정보뿐만 아니라 포스트, 페이지, 댓글, 테마와 플러그인, 구성 설정 등 모든 워드프레스의 정보를 데이터베이스에 저장된다. 

 

워드프레스는 방문자가 웹사이트에 접속할 때마다 데이터베이스에 연결하여 정보를 가져온다. 워드프레스에서 데이터 베이스로 연결할 때에는 데이터베이스의 이름, 사용자 이름, 비밀번호, 서버와 같은 정보가 필요한데, 이 중 하나라도 잘못된 정보가 있으면 워드프레스는 데이터베이스 서버에 연결하지 못하고 "Error establishing a database connection"와 같은 오류 문구를 송출하는 것이다.

 

데이터베이스 연결 오류 원인

• 데이터베이스의 자격증명이 올바르지 않은 경우
• 워드프레스 파일의 손상
• 데이터베이스 손상
• 데이터베이스 서버가 다운된 경우
• 트래픽 급증

 

데이터베이스 연결 오류 해결 방법

워드프레스 데이터베이스 자격 증명 확인하기

오류 발생시 가장 먼저 해야 할 일은 데이터베이스의 자격증명이 올바른지 확인하는 것이다. 데이터베이스의 자격증명이 잘못되면 위와 같은 오류가 발생하는데 이것은 가장 많이 겪는 일반적인 원인이다. 최근 웹사이트를 새로운 호스팅으로 이동했다면 데이터베이스 연결 오류가 발생할 수 있다. 

 

데이터베이스에 관한 주요 설정은 wp-config.php 파일에 저장되어있는데, 여기에 저장되어있는 데이터베이스 정보가 잘못되었다면 에러가 발생하게 되는 것이다. 

 

따라서 연결 오류가 발생했다면 FTP를 통해 사이트에 연결하고 wp-config.php 파일에 접속하여 데이터베이스의 정보를 확인한 다음, 정보를 올바르게 수정한다. 그리고 수정한 다음 다시 웹사이트를 새로고침하여 정상적으로 작동하는지 확인한다.

 

// ** MySQL settings - You can get this info from your web host ** //
/** The name of the database for WordPress */
define( 'DB_NAME', 'database_name_here' );
/** MySQL database username */
define( 'DB_USER', 'username_here' );
/** MySQL database password */
define( 'DB_PASSWORD', 'password_here' );
/** MySQL hostname */
define( 'DB_HOST', 'localhost' );

 

데이터베이스가 손상되었을 경우 복구하기

데이터베이스가 손상되는 경우에도 연결 오류가 발생한다. "Error establishing a database connection" 외에 “One or more database tables are unavailable. The database may need to be repaired.”와 같은 에러 문구가 뜬다면 이는 데이터베이스가 손상되었음을 의미하며 이 에러가 발생하면 데이터베이스를 복구해야 한다.

 

데이터베이스를 복구하는 방법은 다음과 같다. wp-config.php파일에 아래의 코드를 추가하는 것이다.

define('WP_ALLOW_REPAIR', true);

코드를 추가한 다음 본인의 도메인명/wp-admin/maint/repair.php 위치로 이동한 다음 [Repair Database] 또는 [Repair and Optimize Database]를 클릭한다.

 

데이터베이스를 복구한 다음에는 wp-config.php 파일에 삽입했던 코드를 제거한다.

 

호스팅 업체 확인하기

만약 어떤 방법을 써도 데이터베이스에 계속 에러문구가 발생한다면 서버의 문제일 수도 있다. 이런 경우는 호스팅 업체에 확인하여 서버가 정상적으로 동작하고 있는지 확인한다. 

 

서버가 다운되었거나 서버 자체에 문제가 생긴 경우에도 데이터베이스 연결 오류가 발생할 수 있지만 서버의 과도한 트래픽으로 오류가 발생할 수도 있다. 특히 공유 호스팅을 이용하고 있는 경우라면 트래픽 급증으로 데이터베이스 오류가 생길 수 있다.

 

호스팅에 접속하여 트래픽을 확인하고 트래픽 급증이 원인이 아니라면, 지원팀에 데이터베이스 서버가 문제없이 잘 가동되고 있는지 확인한다.