/ 워드프레스

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡


◼︎ 목차 업데이트 : 2019-01-14


워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

"데이터 연결에 에러가 발생하였습니다. (Error Establishing a Database Connection)"

워드프레스(WP: WordPress)로 웹사이트를 직접 설치하여 운영하다보면 이러한 에러 메세지를 보신 적이 누구나 한 번쯤 있으실 것입니다. 특히 워드프레스를 사용한지 얼마 되지 않은 초급 사용자들께서는 이러한 상황에 맞닥들이게 되면 적지 않게 당황하게 마련입니다. 이에 트렌드톡에서 워드프레스에서 데이터베이스 에러와 관련된 몇 가지 상황과 해결 방법에 대해 소개해 드리겠습니다.

주의: 데이터베이스(DB: Database)와 관련된 작업을 하시기 전에, 반드시 백업(Backup)을 해놓으시기를 바랍니다.


데이터베이스 연결 에러의 주요 원인

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

워드프레스에서 데이터베이스 연결에 오류가 발생하는 이유는 여러 가지 원인이 있을 수 있습니다. 데이터베이스 로그인 설정이 틀리거나 변경되었을 수도 있고, 데이터베이스 서버가 응답하지 않기 때문(Unresponsive)일 수도 있습니다. 따라서 상황에 따른 워드프레스의 각 부분을 확인해 볼 필요가 있습니다.


1. 데이터베이스 연결 기능이 손상되었을 경우

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

먼저 워드프레스 웹사이트의 프론트엔드(Front-end)와 백엔드(Back-end, 여기서는 관리자 페이지(wp-admin)를 지칭함)에서 동일하게 “Error establishing a database connection”란 에러 메세지가 나오는지 확인해야 해야 합니다. 만약 같은 메세지가 나온다면, 아래의 다음 확인 사항으로 가시면 됩니다.

하지만 만일 관리자 페이지(wp-admin)에 접속할 때, “One or more database tables are unavailable. The database may need to be repaired”와 같은 에러 메시지가 나온다면, 데이터베이스 연결 기능을 복구(Repair)해야 합니다.

define('WP_ALLOW_REPAIR', true);

"wp-config.php" 파일을 에디터나 CLI(Command Line Interface)로 연 다음, 위의 코드를 ‘That’s all, stop editing! Happy blogging’ 란 코드 라인 바로 위에 붙여 넣으세요.

그 다음, 웹사이트에 다시 접속하면, 아래와 같은 화면이 나오게 됩니다.

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

두 개의 버튼 중 위의 버튼("Repair Database")을 누르면, 손상된 데이터베이스 연결 기능을 자동으로 복구하게 됩니다. 복구가 정상적으로 완료되었다면, 위에서 삽입한 코드 라인(define('WP_ALLOW_REPAIR', true);)을 삭제하세요.

만일 이와 같은 방법으로 문제가 해결되지 않는다면, 다른 부분을 확인해야 합니다.


2. "wp-config file" 파일 설정 확인하기

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

워드프레스의 루트(Root) 디렉토리에 위치한 "wp-config.php" 파일은 워드프레스의 기초 설정과 관련된 내용을 담는 매우 중요한 파일입니다. 데이터베이스 연결에 필요한 사용자명과 비밀번호 등을 이 파일을 통해 수정할 수 있습니다.

define('DB_NAME', '데이터베이스 이름');
define('DB_USER', '데이터베이스 사용자명');
define('DB_PASSWORD', '데이터베이스 비밀번호');
define('DB_HOST', '데이터베이스 호스트명');

여기서 주의해야 할 사항은 데이터베이스 호스트명(DB_HOST)이 반드시 'localhost'가 아닐 수도 있다는 점입니다. 로컬 웹서버가 아닌 외부 호스팅 서비스를 사용 중이라면, 각 회사가 제공하는 설치 매뉴얼이나 직접 문의를 통해, 이 부분을 확인해야 합니다. (대부분의 호스팅 서비스에서는 'localhost'를 사용합니다.)

이 과정을 통해 잘못된 내용이나 오타 요소가 들어가 있는지 확인한 후, 다시 웹사이트에 접속을 시도해 봅니다. 여전히 문제가 발생한다면, 다음 부분을 확인해야 합니다.


3. "데이터베이스 서버 (MySQL Server)" 확인하기

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

데이터베이스 연결 오류는 갑자기 많은 방문 트래픽이 유입되었을 때 발생하고는 합니다. 특히 다른 사용자들과 함께 사용하는 호스팅 서비스(Shared Hosting)를 사용하고 있다면, 그러한 가능성이 더욱 높아집니다. 이런 상황이라면, 먼저 데이터베이스 서버(MySQL을 예시로 합니다)가 응답하는지 확인해야 합니다.

먼저 사용 중인 웹서버 위에 워드프레스 외의 다른 웹사이트가 있다면, 그 웹사이트에 접속이 되는지 확인해야 합니다. 만약 다른 웹사이트에 접속이 된다면, 이는 워드프레스와 연결된 MySQL 서버에 문제가 있다는 의미가 됩니다.

만약 다른 웹사이트에 접속이 되거나, 사용 중인 다른 웹사이트가 없다면, 바로 호스팅 서비스의 "cPanel"이나 직접 주소를 기입하여 "phpMyAdmin"에 접속을 시도해 봅니다. 만일 접속이 된다면, 본인이 사용 중인 사용자명(DB User)의 권한이 유효한지 확인해야 합니다.

"testconnection.php"이란 이름의 새 파일을 만들고 아래의 코드를 붙여 넣습니다.

<?php
$link = mysqli_connect('데이터베이스 호스트명(예: localhost)', '사용자명', '비밀번호');
if (!$link) { die('Could not connect: ' . mysqli_error());
}
echo 'MySQL 서버에 정상적으로 연결되었습니다.';
mysqli_close($link); 
?>

올바른 사용자명과 비밀번호를 입력하고, 주소창에 파일명의 주소를 입력하여 접속이 되는지 확인합니다. 만일 정상적으로 연결된다면, 데이터베이스 사용자 권한에는 문제가 없는 것입니다. 위에서 설명한 "wp-config" 파일을 다시 한 번 열고, 올바른 내용이 입력되어 있는지 확인해 봅니다.


4. 호스팅 회사에 문의하기

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

위의 확인 방법을 통해서도 여전히 웹사이트에 접속할 수 없는 상황이라면, 이는 데이터베이스 사용자 권한에 문제가 있을 가능성이 높습니다. 만일 그렇다면, "phpMyAdmin"에 접속했을 때, 아래와 같은 에러 메세지가 나올 수 있습니다.

#1045 – Access denied for user ‘xxxxxxx’ (using password: YES)

이런 메세지가 화면에 출력된다면, 사용하고 있는 호스팅 서비스 회사에 문의하는 것이 좋습니다. 그리고 앞에서 스스로 확인한 내용을 부연 설명해 준다면, 더욱 신속하게 도움을 받을 수 있습니다.


추가 1. 기타 확인 사항

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

많은 분들이 워드프레스를 처음 사용할 때, 관리자 페이지의 "Site URL"을 잘못 기입하거나 수정하여 에러가 발생하는 경우가 많습니다. 이럴 때에는 "phpMyAdmin"에 접속하거나, CLI를 통해 MySQL 내의 "wp_options" 부분을 기존 내용으로 수정해 주시면 됩니다.

또한 워드프레스에서 발생하는 오류 중에는 테마와 플러그인이 무분별하게 설치되어, 서로 충돌이 일어나는 경우가 매우 많습니다. 오류가 이러한 원인으로 발생된 것으로 예상된다면, 먼저 관리자 페이지 또는 데이터베이스를 통해 기본(디폴트) 테마를 남겨두고, 다른 플러그인들을 비활성화하면서, 정상적으로 작동하는지 확인해 봐야 합니다.


추가 2. 호스팅형 워드프레스 (WordPress.com)

워드프레스(WP)에서 데이터베이스 에러 발생시 체크리스트 및 해결 방법 - 트렌드톡

워드프레스를 직접 설치하여 운영하다보면, 수많은 에러 상황과 부딪칠 수 있습니다. 이러한 것들을 관리하고 해결하는 것이 부담스럽다면, 처음에는 워드프레스에서 제공하는 호스팅형 서비스를 사용하시는 것도 좋은 방법입니다. 제공되는 서비스 레벨에 따라 비용이 소요되는 경우도 있지만, 워드프레스팀이 직접 제공하는 서비스인 만큼, 안정적으로 웹사이트를 운영할 수 있다는 장점이 있습니다.


위와 같은 체크리스트를 바탕으로, 워드프레스를 운영하는 도중에 예상하지 못한 데이터베이스 연결 오류 메세지를 만나게 되더라도, 원활하게 해결하시는데 도움이 되었으면 좋겠습니다.


◼︎ 도움이 될 만한 연관 추천 글


트렌드톡글로벌 비즈니스 및 마케팅에 필요한 유용한 서비스 및 꿀팁을 소개해 드립니다. ( 제휴 및 교육, 기타 문의 (카카오톡) )


트렌드톡 - 글로벌 마케팅 및 비즈니스 최신 정보


저작권자 ⓒ 트렌드톡 ( www.trendtalk.kr ) | 무단 전재 및 재배포 금지