워드프레스 접속오류 데이터베이스 연결 Error establishing a database connection

워드프레스 Error establishing a database connection

워드프레스 웹사이트를 운영하다 보면 어느 날 갑자기 사이트 접속이 되지 않고, 화면에 “Error establishing a database connection”이라는 메시지만 덩그러니 떠 있는 상황을 마주하게 될 수 있는데요 이 메시지는 단순한 경고가 아니라, 웹사이트의 핵심 데이터베이스와의 연결이 끊겼다는 심각한 오류를 나타냅니다.

또한 워드프레스는 데이터베이스를 기반으로 작동하는 CMS(Content Management System)이기 때문에, 이 연결이 정상적으로 이뤄지지 않으면 사이트의 모든 콘텐츠—예를 들어 글, 페이지, 댓글, 사용자 정보 등—가 로딩되지 않아 전체 웹사이트가 마비되는 결과를 낳습니다.

이런 오류는 초보자에게는 당황스럽고 어렵게 느껴질 수 있지만, 사실 그 원인은 비교적 명확한 경우가 많습니다. 가장 흔한 원인으로는 잘못된 데이터베이스 설정 정보—즉, wp-config.php 파일에 입력된 데이터베이스 이름, 사용자명, 비밀번호, 호스트 정보 등이 실제와 일치하지 않을 때—가 꼽힙니다.

그 외에도 서버의 일시적인 문제, 데이터베이스 테이블 손상, 트래픽 폭주로 인한 서버 과부하, 혹은 호스팅 업체의 내부 문제 등 다양한 요소가 복합적으로 작용해 오류가 발생할 수 있습니다.

무엇보다 중요한 점은 이 오류가 단순히 사이트가 보이지 않는다는 불편함을 넘어, 방문자와 검색 엔진 모두에게 치명적인 신호로 작용한다는 것입니다. 사이트 신뢰도에 직접적인 영향을 미치고, 특히 쇼핑몰이나 기업 홈페이지라면 매출 손실로 이어질 수도 있죠.

따라서 문제가 발생했을 때는 원인을 빠르게 파악하고, 적절한 복구 절차를 통해 신속하게 대응하는 것이 무엇보다 중요하며 이에 워드프레스 데이터베이스에서 발생하는 'Error establishing a database connection' 오류에 대하여 다양한 원인부터, 실무에서 바로 적용할 수 있는 해결 방법까지 하나씩 짚어보겠습니다.

728x90

데이터베이스란 무엇인가?

워드프레스의 데이터베이스는 웹사이트의 모든 데이터를 저장하는 핵심 요소입니다.

여기에는 사용자 정보(예: 이름, 비밀번호), 게시물, 페이지, 댓글, 테마, 플러그인, 설정 등이 포함됩니다. 워드프레스는 사용자가 웹사이트에 접속할 때마다 데이터베이스에 연결하여 필요한 정보를 불러오는데, 이 과정에서 문제가 생기면 오류가 발생하게 됩니다.

데이터베이스 연결 오류의 주요 원인

잘못된 데이터베이스 자격 증명

데이터베이스 이름, 사용자 이름, 비밀번호, 서버 정보 등이 올바르지 않으면 워드프레스가 데이터베이스에 연결할 수 없습니다. 이는 종종 호스팅을 변경하거나 설정을 수정하는 과정에서 발생할 수 있는 문제입니다.

워드프레스 파일 손상

워드프레스의 중요한 파일이 손상되면 데이터베이스 연결이 불가능해질 수 있습니다. 이 문제는 주로 플러그인 설치나 테마 업데이트 중 오류가 발생했을 때 나타납니다.

데이터베이스 손상

데이터베이스 자체가 손상되면 연결 오류가 발생할 수 있습니다.

이 경우 "One or more database tables are unavailable. The database may need to be repaired." 같은 메시지가 추가로 나타날 수 있습니다.

데이터베이스 서버 다운

데이터베이스 서버가 다운되거나 응답하지 않을 경우, 워드프레스는 데이터베이스에 접근할 수 없게 됩니다.

트래픽 급증

특히 공유 호스팅 환경에서 트래픽이 급증할 경우, 서버에 과부하가 걸려 데이터베이스 연결 오류가 발생할 수 있습니다.

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

1. 데이터베이스 자격 증명 확인하기

가장 먼저 해야 할 일은 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' );

이 정보가 호스팅 제공업체에서 제공한 정보와 일치하는지 확인하고, 틀린 부분이 있다면 올바르게 수정합니다. 이후 웹사이트를 새로고침하여 문제가 해결되었는지 확인합니다.

2. 데이터베이스 손상 복구하기

데이터베이스가 손상된 경우, wp-config.php 파일에 다음 코드를 추가하여 복구할 수 있습니다:

define('WP_ALLOW_REPAIR', true);

그런 다음, 웹브라우저에서 yourdomain.com/wp-admin/maint/repair.php로 이동합니다.

여기서 [Repair Database] 또는 [Repair and Optimize Database] 버튼을 클릭하여 데이터베이스를 복구합니다. 복구가 완료된 후에는 wp-config.php 파일에서 추가한 코드를 삭제해야 합니다.

3. 호스팅 업체 확인하기

반응형

위의 방법으로도 해결되지 않는다면, 서버 측 문제일 가능성이 높습니다.

오류 메시지 (원문)	설명 및 관련 상황
"Error establishing a database connection"	대표적인 DB 연결 오류. wp-config.php의 DB 정보나 서버 문제로 발생
"One or more database tables are unavailable. The database may need to be repaired."	데이터베이스 테이블 손상 시 발생
"MySQL server has gone away"	서버에서 너무 오래 응답이 없거나, 쿼리 크기 초과 시
"Allowed memory size exhausted"	PHP 메모리 부족으로 발생. DB 연결과 함께 종종 동반됨
"Cannot connect to MySQL server"	MySQL 서버 다운 혹은 접근 권한 문제
"Access denied for user 'username'@'localhost'"	DB 사용자 권한이 없거나 비밀번호 오류
"Too many connections"	동시 접속자가 많거나, DB 연결이 닫히지 않아 연결 초과
"Briefly unavailable for scheduled maintenance"	업데이트 중 연결 끊김 또는 .maintenance 파일 미삭제
"This site is experiencing technical difficulties."	PHP 오류 혹은 플러그인 충돌 시 나타나며 DB 접근 실패 포함 가능

이 경우, 호스팅 업체에 문의하여 서버가 정상적으로 동작하고 있는지 확인하고, 트래픽 급증이나 서버 다운이 원인인지 알아보세요. 특히 공유 호스팅 환경에서는 트래픽 급증이 빈번하게 발생할 수 있습니다.

"Error establishing a database connection" 오류는 여러 원인으로 발생할 수 있지만, 올바른 자격 증명 확인, 데이터베이스 손상 복구, 호스팅 서버 상태 확인 등을 통해 대부분 해결할 수 있습니다.

FAQ

워드프레스 "Error establishing a database connection" 오류가 갑자기 발생했어요. 최근에 한 작업이 없는데 왜 이런 문제가 생겼을까요?

별다른 설정 변경 없이 발생한 경우, 호스팅 서버 측 이슈일 가능성이 높습니다.

특히 공유 호스팅을 사용하는 경우 다른 웹사이트의 트래픽 과부하나 MySQL 서버 점검 등으로 인해 잠시 연결이 차단될 수 있습니다. 이 경우 워드프레스 관리자 화면도 접속되지 않으며, 일정 시간 후 자동 복구되기도 합니다. 반복된다면 호스팅 변경을 고려할 수 있습니다.

워드프레스 "One or more database tables are unavailable" 오류는 무엇인가요?

이 오류 메시지는 Error establishing a database connection과 연관되어 있으며, DB 테이블이 손상되었거나 누락된 경우에 발생합니다. 복구를 위해서는 wp-config.php 파일에 다음 코드를 추가한 뒤 복구 페이지로 접속하세요:

define('WP_ALLOW_REPAIR', true);

이후 https://도메인/wp-admin/maint/repair.php로 이동하여 복구를 진행하고, 복구 완료 후에는 해당 코드를 반드시 제거해야 보안상 안전합니다.

워드프레스 "Error establishing a database connection" 오류에서 DB_HOST를 "localhost"로 설정해도 해결되지 않아요

일부 호스팅 업체는 localhost 대신 다른 MySQL 호스트 주소(예: mysql.abc123.hosting.com)를 사용하는 경우가 있습니다.

wp-config.php의 DB_HOST 값을 호스팅사에서 제공한 정보로 정확히 수정해야 합니다.

해당 정보를 모를 경우, 호스팅 관리 콘솔에서 직접 확인하거나 고객센터에 문의하세요.

워드프레스 MySQL 서버는 정상인데도 "데이터베이스 연결 오류"가 뜹니다. 이럴 땐 어떻게 하나요?

MySQL 서버가 정상 동작 중인데도 오류가 발생한다면, 다음 사항들을 확인하세요.

• wp-config.php의 DB_NAME, DB_USER, DB_PASSWORD가 맞는지
• DB 계정에 해당 데이터베이스에 대한 접근 권한이 제대로 부여되어 있는지
• 사이트에서 사용 중인 캐시 또는 보안 플러그인이 DB 연결을 제한하고 있지 않은지

또한 MySQL 계정에 호스트 제한이 걸려 있다면, 워드프레스가 연결을 못할 수 있으니 이 부분도 확인이 필요합니다.

워드프레스 "MySQL server has gone away" 오류는 무엇인가요?

이 오류는 서버의 응답 대기 시간(timeout)이 지나거나 너무 큰 쿼리를 처리할 때 발생할 수 있습니다.

my.cnf 또는 my.ini 설정에서 wait_timeout, max_allowed_packet 값을 조정해야 해결됩니다. 공유 호스팅 사용자라면 해당 사항을 호스팅 업체에 요청해야 하며, VPS나 클라우드 서버에서는 직접 설정 파일을 수정할 수 있습니다.

워드프레스 관리자 화면은 열리는데 프론트 페이지에서만 "데이터베이스 연결 오류"가 떠요

이 경우는 워드프레스 핵심 파일이 손상되었거나, 특정 플러그인 또는 테마가 DB 연결을 비정상적으로 시도하는 경우가 많습니다. 해결을 위해

• wp-content/plugins 폴더 이름을 일시적으로 변경하여 모든 플러그인 비활성화
• wp-content/themes에서 현재 테마를 twentytwentyfour와 같은 기본 테마로 강제 변경

이후 문제가 해결되면 문제를 일으킨 플러그인이나 테마를 찾아 교체 또는 삭제합니다.

워드프레스 데이터베이스 연결 오류 복구 후에도 사이트가 느려졌어요. 이유가 뭘까요?

데이터베이스 오류 이후 복구가 완료됐더라도, 내부적으로 불필요한 캐시, 임시 데이터, 깨진 테이블 등이 남아 있을 수 있습니다.

이럴 경우 다음을 순서대로 수행해보세요.

• DB 최적화 플러그인(예: WP-Optimize)로 테이블 정리
• 트랜지언트 데이터 삭제
• 오브젝트 캐시/페이지 캐시 재설정
• CDN 사용 중이라면 캐시 재빌드