콘텐츠 관리 시스템(CMS) 시장의 약 50%를 차지하며 사실상 업계 표준으로 자리 잡은 워드프레스. 하지만 아무리 뛰어난 도구라도 사용 중에 한 번쯤은 문제에 부딪히기 마련입니다. 이러한 문제 중 일부는 사용자의 실수에서 비롯되고, 또 일부는 소프트웨어·서버·웹 호스팅 환경의 원인일 수 있습니다.
이 글에서는 워드프레스 사용자들이 자주 겪는 10가지 대표적인 오류와 각각의 해결 방법을 단계별로 자세히 안내해 드립니다.
참고: 이 튜토리얼은 cPanel에 접근할 수 있는 공유 호스팅 환경을 기준으로 작성되었습니다.
1. 흰 화면 오류(White Screen of Death)
이 오류는 '화이트 스크린 오브 데스'라고도 불리며, 화면이 완전히 하얗게 변하고 오류의 원인을 짐작할 만한 단서조차 보여주지 않기 때문에 해결하기 가장 까다로운 문제 중 하나로 꼽힙니다.
원인은 다양하지만 그만큼 해결 방법도 여러 가지가 존재합니다. 아래에 정리된 해결책들을 하나씩 시도해 보시기 바랍니다.
2. 내부 서버 오류(Internal Server Error)
내부 서버 오류는 주로 소프트웨어 충돌, 잘못 작동하는 프로그램, 또는 서비스 장애로 인해 발생합니다. 서버가 PHP나 Apache 같은 서비스를 실행하지 못하거나 연결하지 못할 때 흔히 나타납니다.
서버 업데이트로 인한 오류
사이트에 별다른 변경을 가하지 않았는데 갑자기 이 오류가 나타났다면, 웹 서버의 내부적인 변화(PHP 버전 업그레이드, 플러그인 자동 업데이트로 인한 충돌 등)에 대한 반응일 가능성이 큽니다. 이 경우 웹 호스팅 업체에 문의하여 서버 상태를 점검받으세요.
퍼머링크 오류
사이트의 퍼머링크 구조를 변경한 직후 오류가 발생했다면, 그 변경이 원인일 가능성이 높습니다.
1. cPanel에서 파일 매니저(File Manager)를 엽니다.
2. 'Settings(설정)'를 클릭합니다.
3. 'Show Hidden Files(숨김 파일 표시)' 체크박스에 체크합니다.
'.htaccess' 파일을 찾아 이름을 '.htaccess_old'로 변경합니다.
사이트를 다시 불러와 보세요. 그래도 해결되지 않는다면 퍼머링크를 재설정해야 합니다. 워드프레스 관리자 화면에서 진행할 수 있습니다.
1. 워드프레스 대시보드에서 설정(Settings) → 고유주소(Permalinks)로 이동합니다.
2. 페이지 맨 아래로 스크롤하여 '저장' 버튼을 클릭합니다. 이 과정을 통해 오류 없는 새 '.htaccess' 파일이 자동 생성됩니다.
플러그인/테마 오류
때로는 잘못 작성된 플러그인이 데이터베이스를 건드려 문제를 일으키기도 합니다. 이를 해결하려면 워드프레스 대시보드에 접속해 모든 플러그인을 비활성화하세요. (대시보드에 접근할 수 없다면 FTP나 파일 매니저로 'plugins' 폴더 이름을 'plugins.old'로 바꾸고, 새로 빈 'plugins' 폴더를 하나 만들어 주세요.) 그런 다음 사이트를 다시 불러오고, 정상적으로 접속되면 설치된 플러그인을 하나씩 차례로 재활성화하면서 원인이 되는 플러그인을 찾아냅니다.
또한 테마 업데이트가 원인일 수도 있습니다. 기본 워드프레스 테마로 전환한 후 사이트를 불러와 보세요. 정상적으로 열린다면 문제는 테마에 있는 것입니다.
PHP 메모리 오류
위 방법으로도 해결되지 않는다면 'wp-config.php' 파일에서 최대 메모리 제한을 늘려 PHP 메모리 오류를 해결해야 합니다.
1. cPanel에서 파일 매니저를 엽니다.
2. 'public_html' 폴더를 열고 'wp-config.php' 파일을 찾습니다.
3. 파일을 마우스 오른쪽 버튼으로 클릭해 'Edit(편집)'를 선택합니다. "That's all, stop editing. Happy blogging."이라는 문구를 찾아 그 윗줄에 다음 코드를 추가합니다.
define('WP_MEMORY_LIMIT', '256M');
4. '변경 사항 저장'을 클릭하고 파일을 닫습니다.
3. 데이터베이스 연결 오류(Error Establishing Database Connection)
이 오류는 워드프레스가 데이터베이스에 연결하지 못할 때 발생합니다. 데이터베이스에는 사이트에 표시되는 모든 미디어와 콘텐츠가 담겨 있기 때문에, 이 문제가 생기면 사이트 전체가 오프라인 상태가 됩니다.
MySQL 서버 재시작
cPanel에서 서버 서비스 재시작 옵션을 찾아 MySQL 서버를 재시작한 후, 사이트 연결 상태를 확인합니다. 문제가 지속되면 다음 단계를 따르세요.
데이터베이스 서버 작동 여부 확인
데이터베이스 서버를 재시작한 후에도 연결되지 않는다면, 서버 자체가 다운된 것일 수 있습니다. cPanel에서 phpMyAdmin이나 다른 데이터베이스 관리 도구를 열어 데이터베이스 연결 여부를 확인하세요. 로그인이 되지 않거나 데이터베이스 테이블이 하나도 보이지 않는다면 MySQL 서버에 심각한 문제가 있는 것이므로 즉시 웹 호스팅 업체에 문의해야 합니다.
데이터베이스 테이블 존재 여부 확인
데이터베이스 서버가 정상이라면, 다음으로 워드프레스 테이블이 여전히 존재하는지 확인해야 합니다. 실수로 삭제했거나, 손상되었거나, 악성 코드에 의해 초기화되었을 가능성도 있습니다.
1. cPanel에서 phpMyAdmin을 열어 워드프레스 데이터베이스 테이블을 찾습니다.
2. 테이블이 존재한다면 모두 선택한 후 'Repair Tables(테이블 복구)'를 실행합니다.
데이터베이스 접속 정보 확인
마지막으로 모든 방법이 실패했다면, wp-config.php 파일의 데이터베이스 사용자 정보가 올바른지 확인하세요.
wp-config.php 파일에서 사용자명, 데이터베이스 이름, 호스트, 비밀번호를 점검합니다. 테이블 접두사(prefix)도 올바른지 확인하세요(기본값은 wp_입니다). 잘못된 부분을 수정하면 사이트가 정상으로 돌아옵니다.
4. 워드프레스 대시보드에 접근할 수 없음
이 오류도 비교적 흔하게 발생합니다. 대시보드에 접속을 시도할 때마다 데이터베이스 복구가 필요하다는 메시지가 표시되는 것이 특징입니다.
1. 'wp-config.php' 파일에 다음 코드를 새 줄에 추가합니다.
define('WP_ALLOW_REPAIR', true);
2. 브라우저에서 'https://www.yourwebsite.com/wp-admin/maint/repair.php'로 이동합니다. ('yourwebsite.com'은 본인 사이트 주소로 교체하세요.) 복구 프로세스가 시작되고 데이터베이스의 오류가 자동으로 수정됩니다.
3. 복구가 끝나면 'wp-config.php' 파일로 돌아가 추가했던 코드를 반드시 삭제합니다. 이 코드가 남아 있으면 누구나 복구 페이지에 접근할 수 있어 보안상 위험합니다.
4. 이제 사이트가 문제없이 정상 작동할 것입니다.
문제가 계속된다면 결함이 있는 플러그인이나 테마가 원인일 수 있습니다.
1. wp-content 폴더로 이동합니다.
2. 'plugins' 폴더 이름을 'plugins_old'로 변경하고, 이름이 'plugins'인 새 폴더를 만듭니다.
3. 사이트를 테스트합니다. 대시보드에 접속된다면 결함이 있는 플러그인이 있는 것입니다.
4. 해당 플러그인을 추적하려면 plugins_old 폴더의 플러그인 파일들을 하나씩 새 폴더로 옮깁니다. 파일을 옮길 때마다 대시보드 접속을 시도해 보세요.
5. 결함이 있는 플러그인을 옮기는 순간 대시보드 접근이 다시 막힙니다. 해당 플러그인은 즉시 삭제하세요.
플러그인에 문제가 없었다면 동일한 방법으로 테마 파일도 점검합니다.
5. 연결 시간 초과(Connection Timed Out)
이 오류의 특징적인 증상은 사이트 로딩을 시도한 후 '연결 시간 초과(Connection timed out)' 메시지가 표시되는 것입니다. 데이터베이스 설정이나 워드프레스 코어 파일을 건드린 적이 없다면 더욱 답답하게 느껴질 수 있습니다.
원인은 의외로 단순합니다. 웹사이트가 서버가 감당할 수 있는 것보다 많은 요청을 보내고 있는 것입니다. 다음 해결 방법들을 시도해 보세요.
wp-config.php 파일에서 메모리 제한 늘리기
가장 유력한 원인은 'PHP 메모리 제한 초과'입니다. wp-config.php 파일에 다음 코드를 추가하여 PHP 메모리 제한을 늘릴 수 있습니다.
define('WP_MEMORY_LIMIT', '256M');
모든 플러그인 비활성화
플러그인을 비활성화하면 문제를 일으키는 프로그램을 추적하는 데 도움이 됩니다. 일부 저품질 플러그인은 서버 리소스를 과도하게 소모합니다.
1. 워드프레스 대시보드의 플러그인 메뉴에서 모든 플러그인을 비활성화합니다.
2. 플러그인을 하나씩 천천히 재활성화하면서 어떤 플러그인이 문제를 일으키는지 확인합니다.
호스팅 업그레이드 문의
때로는 현재 호스팅 요금제가 웹사이트의 트래픽을 감당하기에 부족할 수도 있습니다. 이 경우 더 높은 사양의 호스팅 요금제(RAM/메모리 확장)로 업그레이드해야 합니다.
호스팅 업체에 문의해 사이트에 맞는 더 큰 규모의 요금제로 전환하세요. 업그레이드 후에는 더 많은 요청을 처리하고 플러그인의 리소스 요구도 원활하게 수용할 수 있습니다.
6. 워드프레스 관리자 영역에 접근 불가
누구에게나 일어날 수 있는 상황입니다. 비밀번호를 잊어버렸는데 복구용 이메일에도 접근할 수 없다면 정말 곤란하겠죠. 때로는 해킹 시도로 인해 계정 접근이 차단되기도 합니다. 다음 절차를 따라 계정 접근 권한을 다시 확보하세요.
1. cPanel에서 phpMyAdmin을 엽니다.
2. 'Database(데이터베이스)'를 클릭하고 워드프레스 사이트의 데이터베이스를 선택합니다. 'wp_users'(커스텀 접두사를 사용 중이라면 해당 Users 테이블)를 찾아 선택합니다.
3. 목록에서 본인의 워드프레스 사용자명을 찾아 'Edit(편집)'를 클릭합니다.
다음 화면에서 'user_pass' 필드를 찾을 수 있습니다. 기존의 암호화된 값을 지우고 새 비밀번호로 교체합니다.
옆의 드롭다운 메뉴에서 암호화 방식을 'MD5'로 선택합니다. 이는 비밀번호가 외부에 노출되지 않도록 하기 위함입니다.
'Go(실행)'를 클릭한 후 새 비밀번호로 로그인을 시도합니다.
7. 로그인 페이지 무한 리디렉션
이 경우에는 사이트에 접속해도 계속 리디렉션만 반복되어 접근할 수 없습니다. 대부분 로그인 페이지로 몇 번 되돌아간 뒤 연결이 시간 초과되며, 대시보드를 열람할 수 없게 됩니다.
1. 브라우저의 쿠키, 캐시, 방문 기록을 삭제한 후 다시 시도합니다.
2. 위 방법으로 해결되지 않으면 앞서 2번 문제에서 소개한 .htaccess 재설정 방법을 적용해 새 '.htaccess' 파일을 생성한 뒤 로그인을 시도합니다. 대부분의 경우 이것으로 해결됩니다.
3. 5번 문제에서 설명한 방법대로 모든 플러그인을 비활성화해 봅니다.
wp-config.php 파일 수정
여기까지 해도 해결되지 않는다면 다음을 시도해 보세요.
1. wp-config.php 파일에 다음 코드를 추가합니다.
define('WP_HOME','https://yourwebsite.com');
define('WP_SITEURL','https://yourwebsite.com');
변경 사항을 저장한 후 다시 로그인해 보세요. 이번에는 정상적으로 작동할 것입니다.
8. 유지보수 모드에서 멈춤 현상
워드프레스는 플러그인, 테마, 코어 업데이트를 자동으로 처리하지만, 가끔 업데이트 과정에서 문제가 생길 수 있습니다.
정기 유지보수 중에 프로세스가 멈추면 업데이트를 완료하지 못하고 대시보드 접근이 차단됩니다. 방문자에게도 '현재 유지보수 중'이라는 메시지만 표시됩니다.
1. cPanel에 로그인해 파일 매니저를 엽니다.
2. 루트 디렉터리에서 '.maintenance' 파일을 검색하여 삭제합니다.
이 절차만으로 문제가 해결됩니다. 사이트 화면 대신 유지보수 메시지를 표시하는 것은 바로 이 임시 파일 '.maintenance'이기 때문에, 파일을 삭제하면 메시지도 함께 사라집니다.
9. 워드프레스에 이미지를 업로드할 수 없음
이 문제가 발생하면 이미지를 업로드할 수 없거나, 업로드가 완료된 것처럼 보여도 새로고침하면 이미지가 깨져 있거나 사라집니다.
원인은 워드프레스 uploads 폴더에 설정된 권한 문제입니다.
1. cPanel에 로그인해 파일 매니저로 이동합니다.
2. 'public_html' 폴더 → 'wp-content' 폴더 순으로 들어가 'uploads' 폴더를 찾습니다.
3. 'uploads' 폴더를 마우스 오른쪽 버튼으로 클릭하고 'Change Permissions(권한 변경)'를 선택합니다. 아래 이미지의 설정값과 동일하게 입력한 후 저장합니다.
이제 업로드 문제가 해결될 것입니다.
10. 404 오류 수정
포스트나 페이지를 직접 삭제한 경우라면 404 오류는 당연한 결과이므로 신경 쓰지 않아도 됩니다. 하지만 분명히 존재해야 하는 페이지에서 404 오류가 발생한다면 퍼머링크 문제일 가능성이 높습니다.
1. 워드프레스 대시보드에서 설정(Settings) → 고유주소(Permalinks)로 이동합니다.
2. '변경 사항 저장(Save Changes)' 버튼을 클릭합니다.
문제가 해결될 것입니다.
위 방법으로도 해결되지 않는다면 호스팅 업체에 문의하여 mod_rewrite 규칙을 활성화해 달라고 요청하세요.
마무리
지금까지 살펴본 오류들은 워드프레스 사용자를 가장 괴롭히는 대표적인 문제들입니다. 하지만 다음에 마주치더라도 당황할 필요가 없습니다. 위에서 소개한 해결 방법들을 차분히 따라 하면 누구나 전문가의 도움 없이 스스로 문제를 해결하고 웹사이트를 정상화할 수 있습니다. 이제 여러분도 IT 지원팀 없이 워드프레스 오류를 빠르게 해결하는 능력을 갖추게 된 것입니다.