워드프레스 사이트에 접속했는데 갑자기 “데이터베이스 연결 중 오류 발생(Error establishing a database connection)”이라는 문구가 나타날 수 있습니다. 방문자에게는 글이 보이지 않고, 운영자도 관리자 화면에 접속하지 못하는 경우가 있어 당황하기 쉽습니다.

하지만 이 문구가 나타났다고 해서 글이 모두 삭제되었다는 뜻은 아닙니다. 워드프레스가 글과 설정을 보관하는 데이터베이스에 현재 연결하지 못하고 있다는 의미입니다. 연결이 막힌 이유를 확인하고 해결하면 기존 콘텐츠가 다시 표시될 수 있습니다.

이번 글에서는 워드프레스 데이터베이스 연결 오류가 무엇인지 알아보고, 서버 상태부터 설정 파일까지 초보자도 순서대로 확인할 수 있는 점검 방법을 정리하겠습니다.

워드프레스의 데이터베이스는 어떤 역할을 하나요?

워드프레스 사이트는 크게 파일과 데이터베이스를 함께 사용합니다. 테마·플러그인·업로드한 이미지 등은 주로 서버의 파일로 관리하고, 글 내용·페이지·댓글·사이트 설정 등의 정보는 데이터베이스에 저장합니다.

사이트를 열 때 워드프레스는 데이터베이스에 연결하여 필요한 정보를 읽어 옵니다. 이 연결이 실패하면 화면을 만드는 데 필요한 글과 설정을 가져오지 못해 오류 메시지가 나타나는 것입니다.

비유하면 워드프레스는 서점 직원, 데이터베이스는 책의 위치와 내용을 기록한 목록과 비슷합니다. 목록 자체가 사라졌다고 단정할 수는 없지만, 직원이 지금 그 목록을 열어 볼 수 없는 상태라고 이해하면 쉽습니다.

500 오류와 데이터베이스 연결 오류는 어떻게 다른가요?

앞서 살펴본 500 서버 내부 오류는 서버가 요청을 처리하지 못했다는 넓은 의미의 신호입니다. 원인이 플러그인, PHP 코드, 서버 설정 등 다양할 수 있습니다.

반면 데이터베이스 연결 오류는 워드프레스가 데이터베이스와 통신하지 못한다는 좀 더 구체적인 단서를 제공합니다. 그렇다고 오류 문구만 보고 비밀번호가 틀렸다고 바로 판단해서는 안 됩니다. 데이터베이스 서버 장애나 호스팅 환경 변경처럼 설정 파일 밖에 원인이 있을 수도 있습니다.

1. 오류가 언제부터 발생했는지 기록하세요

가장 먼저 사이트 주소와 관리자 주소에 각각 접속해 보세요. 관리자 화면 주소는 일반적으로 사이트 주소 뒤에 /wp-admin/을 붙여 확인할 수 있습니다. 두 곳 모두 같은 오류가 나타나는지, 아니면 일부 화면만 문제인지 살펴보세요.

다음으로 오류가 처음 나타난 시각과 그 직전에 한 작업을 떠올려 보세요. 특히 아래 변경 사항이 있었는지 확인하는 것이 좋습니다.

  • 사이트를 다른 호스팅으로 이전했나요?
  • 도메인이나 서버 설정을 변경했나요?
  • 데이터베이스 비밀번호를 바꿨나요?
  • 워드프레스 파일이나 wp-config.php를 수정했나요?
  • 호스팅 업체에서 서버 이전 또는 점검 안내를 받았나요?

예를 들어 사이트 이전 직후 오류가 발생했다면 이전 과정에서 데이터베이스 주소나 계정 정보가 달라졌을 가능성을 확인할 수 있습니다. 아무것도 변경하지 않았는데 갑자기 발생했다면 먼저 호스팅 서버 상태를 확인하는 편이 자연스럽습니다.

2. 호스팅과 데이터베이스 서버 상태를 확인하세요

워드프레스 파일이 정상이어도 데이터베이스 서버가 잠시 중단되면 연결 오류가 날 수 있습니다. 호스팅 업체의 장애 공지, 관리 페이지의 서비스 상태, 점검 안내 메일을 먼저 확인하세요.

호스팅 관리 화면에서 데이터베이스 서비스가 정상인지 확인할 수 있다면 살펴보세요. 해당 메뉴가 보이지 않거나 상태를 판단하기 어렵다면 고객센터에 “워드프레스에서 데이터베이스 연결 오류가 발생하는데, 데이터베이스 서버가 정상인지 확인해 주세요”라고 문의하면 됩니다.

이 단계에서 서버 장애가 확인되었다면 설정 파일을 서둘러 수정할 필요가 없습니다. 장애가 복구된 뒤 사이트가 다시 열리는지 확인하세요.

3. 설정을 바꾸기 전에 백업부터 확인하세요

오류를 해결하려고 파일을 수정하기 전에 기존 백업이 있는지 확인하세요. 워드프레스는 사이트 파일과 데이터베이스를 함께 백업해야 나중에 제대로 복원하기 쉽습니다.

호스팅에서 제공하는 자동 백업이 있다면 가장 최근의 백업 날짜와 복원 방법을 확인하세요. 직접 백업할 수 없는 상태라면 고객센터에 현재 사이트 파일과 데이터베이스의 백업 가능 여부를 먼저 문의하는 것이 좋습니다.

특히 데이터베이스 연결 문제를 해결한다는 이유로 기존 데이터베이스를 삭제하거나 새 워드프레스를 설치하지 마세요. 원인을 확인하지 않은 재설치나 복원은 현재 데이터를 덮어쓰는 결과로 이어질 수 있습니다.

4. wp-config.php의 연결 정보를 점검하세요

워드프레스는 일반적으로 wp-config.php 파일에 기록된 정보를 이용해 데이터베이스에 연결합니다. 이 파일에는 대표적으로 다음 네 가지 설정이 들어 있습니다.

  • DB_NAME: 연결할 데이터베이스 이름
  • DB_USER: 데이터베이스 사용자 이름
  • DB_PASSWORD: 해당 사용자의 비밀번호
  • DB_HOST: 데이터베이스 서버 주소

이 값은 워드프레스 관리자 로그인 아이디·비밀번호와는 다릅니다. 워드프레스 로그인 비밀번호를 바꾸었다고 해서 DB_PASSWORD도 같은 값으로 바꿔야 하는 것은 아닙니다.

호스팅 파일 관리자에서 wp-config.php를 볼 수 있더라도 기억에 의존해 값을 수정하지 마세요. 먼저 호스팅 관리 화면에서 제공하는 실제 데이터베이스 이름, 사용자 이름, 서버 주소와 비교해야 합니다. 데이터베이스 비밀번호를 최근에 변경했다면 파일에 기록된 값도 함께 변경되었는지 확인하세요.

주의: wp-config.php에는 민감한 정보가 들어 있습니다. 파일 전체를 공개 게시판에 올리거나 상담 화면에 그대로 첨부하지 마세요. 도움을 요청할 때도 비밀번호 부분은 반드시 가려야 합니다.

5. DB_HOST를 무조건 localhost로 바꾸지 마세요

인터넷에서 해결 방법을 찾다 보면 DB_HOST를 localhost로 바꾸라는 설명을 볼 수 있습니다. 그러나 호스팅 업체에 따라 데이터베이스 서버 주소가 따로 지정될 수 있습니다.

따라서 현재 값이 localhost가 아니라고 해서 오류라고 단정하면 안 됩니다. 호스팅 업체가 안내한 데이터베이스 호스트 값을 기준으로 확인하세요. 사이트 이전 후 오류가 생겼다면 이전 호스팅의 주소가 설정 파일에 남아 있지 않은지도 살펴볼 필요가 있습니다.

6. 오류 로그와 최근 변경 내역을 함께 살펴보세요

서버와 설정 정보를 확인했는데도 원인을 찾지 못했다면 호스팅 관리 화면의 오류 로그를 살펴보세요. 데이터베이스 서버 연결 실패, 계정 인증 실패, 자원 제한 등 관련 메시지가 남아 있을 수 있습니다.

로그를 볼 때는 사이트에서 오류가 발생한 시각과 일치하는 기록에 집중하세요. 오래전에 남은 다른 오류를 현재 문제의 원인으로 오해할 수 있기 때문입니다.

로그에 적힌 내용을 이해하기 어렵다면 호스팅 업체에 오류 발생 시각, 사이트 주소, 최근 변경한 작업을 함께 전달하세요. “데이터베이스 연결 오류가 납니다”라는 설명에 이 정보를 더하면 담당자가 확인할 범위를 좁히는 데 도움이 됩니다.

7. 복구 후에는 글과 관리자 화면을 모두 확인하세요

연결 문제가 해결되어 첫 화면이 보이더라도 점검은 한 번 더 필요합니다. 최근 글과 오래된 글을 각각 열어 보고, 관리자 화면에서 글 목록과 설정이 정상적으로 표시되는지 확인하세요.

  • 사이트 첫 화면과 개별 글이 열리는지
  • 관리자 화면에 로그인할 수 있는지
  • 최근에 발행한 글과 이미지가 그대로 있는지
  • 글 저장이나 수정이 정상적으로 되는지
  • 같은 오류가 다시 나타나지 않는지

백업을 복원했다면 특히 백업 이후 작성한 글이 누락되지 않았는지 확인해야 합니다. 문제가 반복된다면 일시적인 장애인지, 서버 자원이나 데이터베이스 설정에 지속적인 문제가 있는지 호스팅 업체와 함께 확인하세요.

핵심은 ‘서버 상태 → 백업 → 연결 설정’ 순서입니다

워드프레스 데이터베이스 연결 오류가 나타났을 때 가장 먼저 해야 할 일은 파일을 수정하는 것이 아닙니다. 오류가 언제 시작됐는지 기록하고, 호스팅의 데이터베이스 서버가 정상인지 확인한 다음, 백업 상태를 살펴보세요. 그 후에 wp-config.php의 연결 정보를 실제 호스팅 설정과 비교하는 순서가 안전합니다.

데이터베이스 연결 오류는 글이 사라졌다는 확정적인 신호가 아닙니다. 침착하게 연결이 끊긴 지점을 찾아보세요. 설정 파일을 다루기 어렵다면 무리해서 값을 바꾸기보다 호스팅 고객센터에 오류 시각과 최근 변경 사항을 알려 주는 것이 좋은 출발점입니다.

참고 자료: 워드프레스 공식 문서: 일반적인 오류, 워드프레스 공식 문서: 백업

사이트노트

글에 대한 의견이나 정정 요청은 문의하기로 보내주세요.

문의하기