이 글의 링크는 추후 제휴 링크로 바뀔 수 있으며, 그 경우 구매 시 수수료를 받을 수 있습니다.
이 글에서 다루는 것
- 사이트에 「데이터베이스 연결 오류」 한 줄만 뜨는 상황에서 무엇부터 확인할지 순서로 정리합니다.
- 워드프레스를 직접 설치해 쓰지만 서버 관리는 익숙하지 않은 분을 위한 글입니다.
- 읽고 나면 내가 고칠 항목과 호스팅사에 물어볼 항목을 나눠서 움직일 수 있습니다.
이 오류가 뜨면 실제로 무슨 일이 일어난 것인가
워드프레스는 글도 설정도 댓글도 전부 데이터베이스에 넣어 둡니다.
방문자가 페이지를 열면 거기 접속해 내용을 꺼내 오는데, 이 접속이 실패하면 화면에 넣을 내용이 하나도 없습니다.
그래서 디자인도 메뉴도 없이 문장 한 줄만 남습니다.
중요한 것은 이 오류가 '워드프레스가 망가졌다'는 뜻이 아니라는 점입니다.
파일은 그대로 있고 접속만 끊긴 경우가 대부분입니다.
원인은 네 갈래로 나뉘고 갈래마다 손댈 사람이 다릅니다.
아래 순서대로 보면 헛수고를 줄일 수 있습니다.
1. 접속 정보 — 최근에 손댄 것이 있는가
워드프레스 공식 문서의 오류 안내 화면입니다.
① 이 오류를 별도 항목으로 다루면서, ② 가장 흔한 원인으로 wp-config.php 의 접속 정보 오류를 먼저 듭니다.
대조하라고 적어 둔 항목은 넷입니다.
데이터베이스 이름, 사용자 이름, 비밀번호, 호스트 주소입니다.
그래서 첫 질문은 '최근에 무엇을 바꿨는가'입니다.
호스팅을 옮겼거나, 비밀번호를 새로 만들었거나, 복원을 돌렸다면 이 네 값 중 하나가 어긋나 있을 가능성이 큽니다.
같은 문서는 설정이 맞는데도 계속 실패하면 데이터베이스 비밀번호를 직접 재설정해 보라고 안내합니다.
손댄 것이 전혀 없는데 갑자기 떴다면 이 항목은 넘깁니다.
2. 연결 수 상한 — 자리가 다 찼을 때
새로고침하면 열렸다가 다시 안 열리는 식으로 들쭉날쭉하다면 연결 수를 의심합니다.
데이터베이스는 동시에 받아 줄 접속 수가 정해져 있습니다.
MySQL 공식 문서의 해당 항목입니다.
① 'Too many connections' 오류는 남은 연결 자리를 다른 접속이 전부 쓰고 있다는 뜻이고, ② 허용 개수는 max_connections 설정값이 정한다고 적혀 있습니다.
값을 올리면 더 받을 수 있지만, 연결 하나하나가 메모리를 쓰므로 서버 자원과 같이 봐야 합니다.
자리가 차는 이유는 대개 둘입니다.
방문자가 몰려 정상 접속이 늘었거나, 무거운 질의가 끝나지 않고 자리를 붙잡고 있는 경우입니다.
뒤쪽이라면 최근 추가한 플러그인이 의심 대상입니다.
이 값은 서버 설정이라 공유 호스팅에서는 직접 만질 수 없습니다.
3. 서버 자원 — 호스팅이 부족하다고 말하는 신호
워드프레스 공식 문서는 호스팅 쪽 원인으로 두 가지를 듭니다.
데이터베이스가 할당량을 넘겨 중지된 경우, 그리고 서버 자체가 내려간 경우입니다.
둘 다 내 파일을 들여다봐도 나오지 않으니, 이 단계에서는 호스팅사에 '지금 데이터베이스가 떠 있는지', '용량 한도를 넘겼는지' 두 가지를 짚어서 묻는 편이 빠릅니다.
그 전에 내가 쓰는 상품의 자원이 얼마인지는 알고 있어야 합니다.
메모리와 저장공간은 요금제마다 정해져 있습니다.
한 관리형 호스팅의 요금 페이지를 오늘 직접 연 화면입니다.
① 가장 낮은 요금제가 월 14달러(세금 별도)이고, ② 메모리 1GB, ③ 저장공간 25GB가 그 요금에 묶여 있습니다.
숫자가 붙어 있어야 '내 사이트가 이 안에서 도는 중인가'를 판단할 기준이 생깁니다.
저장공간이 꽉 차면 데이터베이스가 쓰기를 못 하므로, 백업 파일과 로그가 쌓여 있지 않은지도 같이 봅니다.
메모리 1GB가 어떤 요금제인지 공식 요금표에서 직접 보기
4. 데이터베이스 손상 — 복구 기능을 켜 보기
접속 정보도 맞고 서버도 살아 있는데 관리자 화면까지 안 열린다면 테이블이 손상됐을 수 있습니다.
워드프레스에는 이때 쓰라고 만든 복구 기능이 있습니다.
워드프레스 공식 문서의 설정 안내입니다.
① 자동 복구 기능이 있고, ② wp-config.php 에 WP_ALLOW_REPAIR 한 줄을 넣으면 켜집니다.
사이트 주소 뒤에 /wp-admin/maint/repair.php 를 붙이면 복구 화면이 열립니다.
같은 문서가 붙여 둔 경고를 반드시 같이 읽어야 합니다.
이 기능이 켜져 있는 동안에는 로그인하지 않은 사람도 그 주소로 들어갈 수 있습니다.
데이터베이스가 망가지면 로그인 자체가 안 되기에 그렇게 만든 것입니다.
복구가 끝나면 넣었던 한 줄을 지워야 합니다.
증상별로 어디부터 보나
| 증상 | 먼저 볼 곳 | 확인 방법 |
|---|---|---|
| 이사·복원·비밀번호 변경 직후부터 | 접속 정보 | wp-config.php 의 네 값 대조 |
| 새로고침하면 열렸다 안 열렸다 | 연결 수 | 방문자 급증·신규 플러그인 확인 |
| 계속 안 열리고 관리자도 안 됨 | 서버 자원 | 호스팅사에 가동 여부·용량 한도 문의 |
| 일부 페이지만 깨져 보임 | 테이블 손상 | 복구 기능을 켜서 점검 |
호스팅이 원인일 때의 선택지
같은 오류가 자원 부족 때문에 반복된다면 그때는 호스팅 쪽을 봅니다.
관리형 클라우드 호스팅인 클라우드웨이즈는 서버 자원이 요금제에 숫자로 적혀 있고 나중에 사양만 올리는 방식이라, 지금 어디에 걸렸는지 확인하기는 수월한 편입니다.
다만 처음부터 큰 요금제로 갈 이유는 없습니다.
가장 낮은 요금제로 시작해 메모리 사용률이 계속 높게 유지될 때 올리는 순서가 낫습니다.
서버 자원을 늘릴 때 어디를 올리는지 공식 안내에서 살펴보기
단점도 같이 적겠습니다.
결제가 달러라 환율에 따라 금액이 흔들리고, 표시 요금에 세금이 빠져 있습니다.
관리 화면과 고객지원이 영어이고, 메일 호스팅은 포함되지 않습니다.
월 1만 원 이하 공유 호스팅으로 충분한 사이트, 워드프레스나 PHP를 쓰지 않는 사이트, 문제가 생겼을 때 한국어 전화 상담이 꼭 필요한 분에게는 맞지 않습니다.
자주 묻는 질문
데이터베이스 연결 오류가 뜨면 글이 다 날아간 건가요?
아닙니다.
대부분 접속만 끊긴 상태라 데이터는 그대로 있습니다.
원인을 모른 채 다시 설치하는 것은 위험하니, 손대기 전에 백업부터 확인하시기 바랍니다.
wp-config.php 는 어떻게 열어 보나요?
FTP 프로그램이나 호스팅사의 파일 관리자로 사이트 최상위 폴더에 들어가면 있습니다.
고치기 전에 원본을 복사해 두고, 값 앞뒤 따옴표를 건드리지 않게 조심합니다.
혼자 해결할 수 있는 항목과 아닌 항목은 어떻게 나누나요?
접속 정보와 복구 기능은 직접 할 수 있습니다.
연결 수 상한과 서버 가동 여부, 용량 한도는 공유 호스팅에서 직접 만질 수 없으니 호스팅사에 문의해야 합니다.
복구 기능은 켜 두면 안 되나요?
안 됩니다.
공식 문서대로 켜져 있는 동안에는 로그인 없이도 복구 화면에 들어갈 수 있습니다.
쓰고 나면 넣은 줄을 지워 다시 잠가야 합니다.
마무리
이 오류는 워드프레스가 망가진 것이 아니라 데이터베이스와의 접속이 끊긴 상태입니다.
최근에 손댄 것이 있으면 접속 정보 네 값부터, 들쭉날쭉하면 연결 수부터, 계속 안 열리면 서버 자원과 가동 여부부터 봅니다.
복구 기능은 마지막 수단이고, 쓰고 나면 반드시 다시 꺼야 합니다.
이 오류를 만난 적이 있으신가요?
화면에 뜬 문장과 그 직전에 하신 작업을 댓글로 남겨 주시면 어느 갈래인지 같이 짚어 보겠습니다.
다음 글에서는 「블로그 이미지 용량 줄이는 법, WebP와 지연 로딩」에 대해 알아보겠습니다.