워드프레스 데이터베이스 연결 오류는 사이트 첫 화면이나 관리자 페이지를 열었을 때 갑자기 나타날 수 있다. 화면에는 데이터베이스 연결 설정 오류라는 문구만 보이고 글, 이미지와 관리자 메뉴가 모두 열리지 않을 때도 있다.
워드프레스 데이터베이스 연결 오류가 나타났다고 해서 글과 페이지가 모두 삭제된 것은 아니다. 워드프레스가 사이트 정보를 보관한 데이터베이스에 연결하지 못해 내용을 불러오지 못하는 상태일 수 있다.
이때 데이터베이스를 새로 만들거나 기존 테이블부터 수정하면 복구가 더 어려워질 수 있다. 서버 장애 여부, 최근 변경 사항과 접속 정보처럼 확인하기 쉬운 항목부터 살펴봐야 한다.
이 글에서는 워드프레스 데이터베이스 연결 오류가 발생했을 때 초보자가 안전하게 확인할 5단계를 정리한다.
워드프레스 데이터베이스 연결 오류는 왜 생길까?
워드프레스의 글, 페이지, 사용자와 설정 정보는 데이터베이스에 저장된다. 사이트 파일은 남아 있어도 데이터베이스 서버에 연결하지 못하면 화면에 필요한 내용을 불러올 수 없다.
대표적인 원인은 다음과 같다.
- 호스팅 데이터베이스 서버의 일시적인 장애
wp-config.php에 입력된 접속 정보 오류- 데이터베이스 비밀번호 변경 후 설정 미반영
- 데이터베이스 사용자 권한 부족
- 사이트 이전 과정에서 잘못 입력한 DB 호스트
- 데이터베이스 손상이나 서버 저장 공간 부족
1. 잠시 기다린 뒤 서버 상태를 확인한다
사이트를 수정하지 않았는데 갑자기 오류가 나타났다면 호스팅 서버 장애부터 확인한다. 데이터베이스 서버가 잠시 중단되거나 점검 중인 경우에는 파일을 수정하지 않아도 시간이 지나면서 정상으로 돌아올 수 있다.
- 시크릿 창에서 사이트 첫 화면을 다시 연다.
- 관리자 주소인
/wp-admin/도 확인한다. - 호스팅 업체의 장애와 점검 공지를 확인한다.
- 5분에서 10분 뒤 다시 접속한다.
- 같은 호스팅의 다른 사이트도 문제가 있는지 살펴본다.
사이트를 변경하지 않았고 여러 페이지가 동시에 열리지 않는다면 서버 상태를 먼저 문의하는 편이 안전하다.
2. 오류가 시작되기 전 변경 사항을 확인한다
워드프레스 데이터베이스 연결 오류가 사이트 이전이나 호스팅 변경 직후 나타났다면 최근 작업을 확인한다.
- 도메인이나 서버를 이전했는지
- 데이터베이스를 새 서버로 가져왔는지
- DB 사용자 비밀번호를 변경했는지
wp-config.php파일을 수정했는지- 백업 파일을 복원했는지
- 호스팅 상품이나 PHP 환경을 변경했는지
변경 전 파일과 설정 화면이 남아 있다면 현재 값과 비교한다. 기억에 의존해 접속 정보를 다시 입력하기보다 호스팅 관리 화면에 표시된 실제 값을 확인해야 한다.
3. wp-config.php의 데이터베이스 정보를 확인한다
워드프레스는 설치 폴더의 wp-config.php 파일에서 데이터베이스 연결 정보를 읽는다. 워드프레스 공식 문서도 연결 오류가 나타날 때 다음 네 가지 값을 먼저 확인하도록 안내한다.
define( 'DB_NAME', '데이터베이스이름' );
define( 'DB_USER', '데이터베이스사용자명' );
define( 'DB_PASSWORD', '데이터베이스비밀번호' );
define( 'DB_HOST', '데이터베이스호스트' );각 값은 호스팅 관리 화면에 표시된 정보와 정확히 같아야 한다. 데이터베이스 호스트는 환경에 따라 localhost가 아닐 수 있으며 포트나 별도 서버 주소가 필요한 경우도 있다.
먼저 확인해야 한다.
wp-config.php를 수정하기 전에 원본 파일을 내려받아 보관한다. 데이터베이스 비밀번호와 보안 키가 들어 있으므로 파일 내용이나 화면 캡처를 외부에 공개하지 않는다.
따옴표, 세미콜론이나 괄호를 잘못 지우면 다른 오류가 생길 수 있다. 필요한 값만 수정하고 파일 이름이나 확장자는 바꾸지 않는다.
4. 데이터베이스 사용자와 권한을 확인한다
접속 정보가 맞는데도 워드프레스 데이터베이스 연결 오류가 계속된다면 데이터베이스 사용자 권한을 확인한다.
데이터베이스와 사용자가 각각 존재하더라도 사용자가 해당 데이터베이스에 연결되지 않았거나 필요한 권한이 빠져 있을 수 있다.
- 데이터베이스가 실제로 존재하는지
- 등록된 DB 사용자가 삭제되지 않았는지
- 사용자가 해당 데이터베이스에 연결돼 있는지
- 비밀번호 변경 사항이 반영됐는지
- 읽기와 쓰기에 필요한 권한이 있는지
카페24 같은 관리형 호스팅에서는 직접 권한을 변경하기보다 고객센터에 데이터베이스 이름과 사용자 연결 상태를 확인해 달라고 요청하는 편이 안전하다.
주의: 기존 데이터베이스를 삭제하거나 새 데이터베이스로 교체하지 말아야 한다. 잘못된 데이터베이스에 연결하면 빈 사이트처럼 보이거나 설치 화면이 나타날 수 있다.
5. 데이터베이스 상태와 백업 복구를 요청한다
접속 정보와 사용자 권한에도 문제가 없다면 데이터베이스 서버 상태나 테이블 손상 여부를 확인해야 한다.
호스팅 고객센터에는 다음 정보를 전달한다.
- 오류가 시작된 날짜와 시간
- 사이트 이전이나 DB 비밀번호 변경 여부
- 현재 데이터베이스 이름과 호스트
- 관리자 화면도 같은 오류가 나타나는지
- 데이터베이스 서버 접속 가능 여부
- 최근 정상 백업이 남아 있는지
데이터베이스 복구 기능을 임의로 실행하기보다 호스팅 업체에서 테이블 상태와 서버 로그를 먼저 확인하도록 요청한다. 쇼핑몰이나 회원 사이트는 오래된 데이터베이스를 복원하면 최근 주문과 회원 정보가 사라질 수 있다.
워드프레스 공식 오류 안내와 설정 파일 설명은 워드프레스 일반 오류 안내와 wp-config.php 공식 안내에서 확인할 수 있다.
복구 후 확인할 항목
- 사이트 첫 화면과 주요 글을 직접 연다.
- 관리자 페이지에 로그인한다.
- 글 저장과 이미지 업로드를 시험한다.
- 사이트 건강 화면에서 데이터베이스 정보를 확인한다.
- 최근 주문, 회원과 댓글이 남아 있는지 살펴본다.
- 복구된 상태의 파일과 데이터베이스를 다시 백업한다.
워드프레스 데이터베이스 연결 오류가 반복된다면 발생 시간과 서버 상태를 기록한다. 특정 시간에만 문제가 나타난다면 데이터베이스 서버 자원이나 접속 제한을 함께 확인할 필요가 있다.
자주 묻는 질문
데이터베이스 연결 오류가 뜨면 글이 모두 사라진 것인가?
오류 화면만으로 데이터가 삭제됐다고 볼 수는 없다. 워드프레스가 데이터베이스에 연결하지 못해 글을 불러오지 못하는 경우가 많다. 기존 데이터베이스를 삭제하지 말고 연결 상태부터 확인한다.
DB_HOST는 항상 localhost를 입력하면 되나?
호스팅 환경에 따라 다르다. 별도의 데이터베이스 서버 주소, 포트나 소켓 경로가 필요할 수 있다. 호스팅 관리 화면이나 고객센터에서 정확한 값을 확인해야 한다.
비밀번호가 맞는데도 연결 오류가 날 수 있나?
그럴 수 있다. 데이터베이스 사용자 권한이 없거나 DB 서버가 중단된 경우에도 같은 오류가 나타날 수 있다. 데이터베이스 이름, 사용자와 호스트도 함께 확인한다.
데이터베이스 복구 코드를 바로 실행해도 되나?
연결 정보 오류나 서버 장애가 원인이라면 복구 코드가 필요하지 않을 수 있다. 먼저 백업을 확보하고 호스팅 업체에 테이블 손상 여부를 확인한 뒤 결정하는 편이 안전하다.
워드프레스 데이터베이스 연결 오류 해결 방법 정리
- 사이트 변경 전이라면 호스팅 서버 장애부터 확인한다.
- 오류가 시작되기 전의 이전·비밀번호 변경 작업을 살펴본다.
wp-config.php의 DB 이름, 사용자, 비밀번호와 호스트를 확인한다.- 데이터베이스 사용자 연결과 권한을 점검한다.
- 서버 상태와 테이블 손상 여부를 호스팅 고객센터에 문의한다.
워드프레스 데이터베이스 연결 오류는 데이터베이스를 새로 만들기보다 서버 상태와 접속 정보부터 확인해야 한다. 파일과 데이터베이스를 수정해야 한다면 현재 상태를 백업한 뒤 필요한 부분만 다루는 편이 안전하다.
사이트 주소를 변경한 뒤 오류가 시작됐다면 워드프레스 주소 변경 후 접속 안 될 때 복구하는 3가지 방법을 함께 확인한다.
지금 바로 할 일
최근 사이트 이전이나 데이터베이스 비밀번호 변경이 있었는지 먼저 기록한다. 변경한 적이 없다면 호스팅 장애 여부를 확인하고, 변경한 적이 있다면 wp-config.php 원본을 백업한 뒤 호스팅 관리 화면의 DB 정보와 비교한다.
