WordPress는 세계에서 가장 인기 있는 CMS이지만, 서버 설정 문제, URL 오류 또는 사용자 측의 기타 원인으로 인해 발생하는 문제에서 완전히 자유롭지는 않습니다.
대부분의 오류는 '404 페이지를 찾을 수 없음'이나 '503 임시 서버 오류'처럼 메시지 자체로 원인을 짐작할 수 있지만, 500 Internal Server Error(500 내부 서버 오류)는 그렇지 않습니다. 이 글에서는 이 문제를 단계별로 해결하는 방법을 자세히 안내해 드립니다.
500 내부 서버 오류란 무엇인가?
흥미로운 점은 이 오류가 특정한 하나의 원인을 가리키지 않는다는 것입니다. 그래서 오류 메시지에 구체적인 설명이 포함되지 않죠. 서버 스스로도 정확한 원인을 파악하지 못해 혼란스러운 상태이기 때문입니다. 무엇을 고쳐야 할지 모르는 상태에서는 문제를 해결하기 어렵겠죠?
다행히도 오랜 경험과 사례 분석을 통해 이 오류의 대부분은 몇 가지 공통된 원인에서 비롯된다는 사실이 밝혀졌습니다. 아래 항목 중 하나 또는 여러 개를 점검하고 수정하면 대체로 문제가 해결됩니다.
- .htaccess 파일의 문제
- PHP 메모리 제한 부족
- 테마 관련 문제
- 플러그인 관련 문제
오류가 관리자 화면(WpAdmin)에만 나타나든, 사이트 전체에 나타나든 아래 방법으로 해결할 수 있습니다.
플러그인 문제 확인 및 해결하기
플러그인은 WordPress 사이트에 추가되는 서드파티 코드로, 항상 안정적이고 완성도 높은 것이라고 보장할 수 없습니다. 그래서 서버 오류 같은 문제가 발생하기도 하죠. 우선 문제가 실제로 플러그인 때문인지 확인해야 합니다.
확인 방법은 간단합니다. 모든 플러그인을 비활성화한 후 사이트를 확인하세요. 백엔드가 정상이고 메인 사이트에만 문제가 있다면, 관리자 패널에 로그인하여 플러그인을 비활성화하면 됩니다.
만약 관리자 대시보드에 접근할 수 없다면, 호스팅 계정(cPanel)에 로그인하거나 FTP 클라이언트를 사용해 WordPress 파일에 접속하세요. 그런 다음 wp-content > plugins 폴더로 이동해 'plugins' 폴더 이름을 'plugins-check' 등 다른 이름으로 변경합니다.
폴더 이름을 바꾸면 모든 플러그인이 자동으로 비활성화됩니다. 문제의 원인이 플러그인이었다면 사이트가 정상적으로 작동할 것입니다. 이제 WpAdmin 대시보드에 로그인해 플러그인을 하나씩 다시 활성화해 보세요.
오류가 다시 나타날 때까지 반복하면, 마지막에 활성화한 플러그인이 원인임을 알 수 있습니다.
반대로 플러그인을 비활성화해도(WpAdmin 패널 또는 FTP/cPanel 사용) 사이트가 복구되지 않는다면 플러그인이 원인이 아닌 것입니다. 폴더 이름을 다시 'plugins'로 되돌리거나 관리자 패널에서 모든 플러그인을 활성화한 후, 다음 해결 방법으로 넘어가세요.
PHP 메모리 문제 해결하기
먼저 이 문제가 무엇을 의미하는지, 왜 발생하는지 살펴보겠습니다. 일반 컴퓨터가 다양한 소프트웨어를 실행하려면 메모리(RAM)가 필요하듯이, WordPress 사이트 역시 원활하게 작동하려면 적절한 양의 메모리가 필요합니다. 필요한 메모리가 부족하면 오류가 발생하는 것이죠.
해결 방법은 어렵지 않습니다. WordPress가 설치된 디렉터리에서 wp-config.php 파일을 찾아 엽니다. 그리고 파일의 마지막 줄 바로 앞에 아래 코드를 복사해 붙여넣으세요.
define( 'WP_MEMORY_LIMIT', '256M' );
파일을 저장한 후 사이트로 돌아가 새로 고침 버튼을 누르면, 운이 좋다면 모든 것이 정상으로 돌아올 것입니다.
테마 문제 해결하기
테마 역시 플러그인처럼 문제의 원인이 될 수 있습니다. 차이점이 있다면, 플러그인과 달리 테마는 한 번에 '하나'만 사용한다는 점입니다. 따라서 현재 사용 중인 테마가 원인이거나, 아니면 원인이 아닌 둘 중 하나입니다.
확실하게 확인하는 가장 간단한 방법은 현재 테마를 비활성화하고 다른 테마로 전환해 보는 것입니다. 이것으로 문제가 해결되었다면 새 테마를 계속 사용하거나, 테마 제공업체에 문의해 원래 테마의 문제를 수정 요청하면 됩니다.
'차일드 테마(Child Theme)'를 사용 중이라면 차일드 테마를 삭제하고 고유주소(Permalink) 구조를 '글 이름(Postname)'으로 설정해 보세요. 이 방법으로 문제가 해결되었다는 사용자 보고도 있습니다.
만약 이 방법으로도 해결되지 않았고 위의 세 가지 방법을 모두 시도했다면, 마지막 해결책이 남아 있습니다.
.htaccess 파일 수정하기
.htaccess 파일은 WordPress 설치 환경에서 크기는 작지만 가장 중요한 파일 중 하나입니다. WordPress가 설치된 동일한 디렉터리에 위치하며, cPanel에 로그인하거나 FTP 클라이언트를 통해 접근할 수 있습니다.
해야 할 일은 간단합니다. .htaccess 파일의 이름을 '.htaccess_error' 등 다른 이름으로 변경하세요. 이렇게 하면 해당 파일이 더 이상 작동하지 않게 됩니다. 이제 사이트를 새로 고침해 보세요. 사이트가 정상적으로 열린다면 .htaccess 파일이 문제의 원인이었던 것입니다.
하지만 잠깐, 사이트가 제대로 작동하려면 여전히 올바른 .htaccess 파일이 필요합니다. WpAdmin 영역에서 설정 > 고유주소(Permalinks)로 이동한 후, 아무것도 변경하지 않은 채 '변경 사항 저장' 버튼을 클릭하세요.
그러면 새로운 .htaccess 파일이 자동 생성되며, 모든 과정이 끝납니다.
위의 방법들이 500 내부 서버 오류를 해결하는 데 필요한 거의 모든 옵션입니다. 만약 문제가 여전히 해결되지 않았다면, 000Webhost에서 제공하는 더 상세한 500 내부 서버 오류 해결 가이드를 참고해 보시길 권합니다.
마무리
여기까지 입니다. 대부분의 경우 위에서 소개한 해결 방법들로 오류를 성공적으로 수정할 수 있습니다.
만약 그래도 문제가 해결되지 않았다면, 댓글로 구체적인 상황을 알려주세요. 최선을 다해 답변해 드리겠습니다.