WordPress Error establishing a database connection 오류 해결 방법을 살펴보겠습니다.
목차
WordPress Error establishing a database connection 설명
아래와 같이 Error establishing a database connection 오류가 발생하는 경우가 있습니다. 말 그대로 데이터 베이스에 연결할 수 없는 상황입니다.
처음 워드프레스를 설치하고 DB 설정을 하지 않은 경우
워드프레스에서는 특정 DB에 접속하도록 wp-config.php에 설정해 두거나, docker를 이용하는 경우 WORDPRESS_DB_NAME을 환경변수로 설정하게 되는데, 해당 DB를 생성도 하지 않았다면 당연히 해당 DB에 접속할 수가 없겠죠.
DB를 아직 만들지도 않았다면, DB 서버에서 다음과 같이 Database를 먼저 생성하시기 바랍니다. 저는 DB 이름을 mydb로 해 보았습니다.
CREATE DATABASE mydb;DB 생성 뿐 아니라 해당 DB에 접속할 권한이 있는 사용자도 추가해서 설정해 줘야 합니다. 이 부분은 다음 항에서 설명하겠습니다.
DB에 접속할 자격이 없는 경우
FTP 또는 호스팅 파일 관리자에서 wp-config.php 파일을 엽니다. DB_NAME, DB_USER, DB_PASSWORD, DB_HOST 항목을 올바르게 입력했는지 확인합니다.
Docker로 WordPress를 이용하는 경우라면 docker 구동시에 설정한 환경변수 WORDPRESS_DB_HOST, WORDPRESS_DB_USER, WORDPRESS_DB_PASSWORD, WORDPRESS_DB_NAME의 항목이 바르게 설정되어있는지 확인합니다.
데이터베이스에는 해당 DB로 접속할 권한이 있는 사용자가 반드시 있어야 합니다. 만약 DB에 사용자를 추가하지 않은 경우라면 해당 DB에 접속할 권한을 가진 사용자를 만들어 주셔야 합니다.
이전에 포스팅 한 MariaDB, MySQL 사용자 추가, 권한부여, 권한적용에서 MariaDB/MySQL의 사용자 추가 방법에 대해 상세하게 정리해 두었으니, 해당 포스팅을 참고하시면 도움이 될 것입니다.
워드프레스를 처음 세팅하는 분의 경우에는 DB에 접속할 준비가 모두 되면 https://도메인명/wp-admin/install.php로 이동해서 설치를 진행할 수 있게 됩니다. 이미 설치해서 사용하는 분이라면 자신의 워드프레스에 접속할 수 있게 됩니다.
데이터베이스 서버 다운 또는 네트워크 문제 확인
데이터베이스 서버가 점검 중이거나 재부팅 중이라는 것을 알고 있을 때에는 서버가 정상 가동될 때까지 기다렸다가 접속해 보시기 바랍니다.
만약 시간이 지났는데도 DB 서버로의 접속이 불가능하다면 호스팅 업체 등의 DB 서버를 관리하는 곳에 문의해서 데이터베이스 서버의 상태를 확인하신 후, 정상 가동 중이라면 마지막으로 다른 원인은 없는지 확인해야 합니다.
마지막으로 확인할 것
우선 데이터베이스 서버가 정상 작동하고, 워드프레스의 설정파일 등에 문제가 없다면 접속이 정상적으로 돼야 합니다. 만약 데이터베이스 서버가 정상 작동하고, DB 서버에 접속할 사용자 계정도 준비가 되었고, 워드프레스의 설정도 정상인데 문제가 발생한다면, 네트워크 상에 문제가 있는 것은 아닌지도 확인해야 합니다. 그 외에도 서버 리소스 부족으로 저장 공간이 부족하거나 메모리가 부족한 것은 아닌지도 확인해 보시기 바랍니다. DB가 손상됐을 수도 있습니다. 물론 DB가 손상된 경우라면 DB를 복구해야 합니다.
우선 제가 말씀드릴 수 있는 내용은 이정도입니다. 기본적으로는 DB 서버 설정이 잘 되고, 워드프레스 설정이 잘 되었다면 문제 없이 접속되는 게 맞습니다. 그 외의 경우라면 하나씩 잘 확인해서 해결하시기 바랍니다.
관련 자료
워드프레스의 topic을 참고했습니다.