글 목차
워드프레스 500 Internal Server Error 해결 방법 완벽 가이드
워드프레스 사이트를 운영하다 보면 갑자기 흰 화면이나 “500 Internal Server Error” 메시지를 마주치는 상황이 발생합니다. 방문자에게도 오류가 그대로 노출되어 당황스러울 수 있습니다. 이번 글에서는 500 에러의 주요 원인과 카페24 호스팅 환경에서 단계별로 해결하는 방법을 안내합니다.
500 Internal Server Error란?
500 에러는 서버 내부에서 처리 과정 중 예기치 않은 문제가 발생했을 때 나타나는 HTTP 상태 코드입니다. 클라이언트(방문자) 측이 아닌 서버 측 문제이며, 워드프레스에서는 다양한 원인으로 발생할 수 있습니다.
주요 증상
- 사이트 전체 또는 일부 페이지에 흰 화면만 표시됨
- 브라우저에 “500 Internal Server Error” 메시지 노출
- 워드프레스 관리자 화면도 접근 불가능한 경우
- 일부 기능(글 저장, 미디어 업로드)만 오류가 발생하는 경우
500 에러의 주요 원인 4가지
1. .htaccess 파일 손상
.htaccess는 아파치(Apache) 서버의 핵심 설정 파일입니다. 이 파일이 손상되거나 잘못된 설정이 추가되면 500 에러가 발생합니다. 워드프레스 업데이트, 플러그인 설치 시 자동 수정되는 경우가 많습니다.
2. PHP 메모리 한도 초과
워드프레스 사이트에 필요한 PHP 메모리가 서버에 설정된 한도를 초과하면 에러가 발생합니다. 기본값이 낮게 설정된 공유 호스팅 환경에서 자주 발생합니다.
3. 플러그인 또는 테마 충돌
새로 설치하거나 업데이트한 플러그인, 테마가 PHP 오류를 발생시키거나 다른 플러그인과 충돌하는 경우입니다. 가장 흔한 원인 중 하나입니다.
4. 워드프레스 코어 파일 손상
워드프레스 핵심 파일이 불완전하게 업데이트되거나 손상된 경우입니다. FTP로 파일을 재업로드하여 해결할 수 있습니다.
카페24 호스팅에서 500 에러 해결 방법
1단계: 오류 로그 확인
먼저 정확한 원인을 파악하기 위해 오류 로그를 확인합니다. 카페24 호스팅 제어판에 로그인한 후 다음 경로로 이동합니다.
- 카페24 호스팅 제어판 접속
- 상단 메뉴에서 호스팅 관리 선택
- 로그 관리 → 에러 로그 확인
- 가장 최근 에러 메시지를 기록해 둡니다
오류 로그에서 파일 경로나 플러그인 이름이 보이면 해당 항목부터 점검합니다.
2단계: .htaccess 파일 초기화
.htaccess 손상이 의심되는 경우 다음 방법으로 초기화합니다.
- 카페24 호스팅 제어판 → FTP 파일 관리자 접속
- 워드프레스 루트 디렉토리(예: /www/ 또는 /public_html/)로 이동
- .htaccess 파일을 선택하여 이름을
.htaccess_backup으로 변경 - 새 .htaccess 파일을 생성하고 아래 기본 코드를 붙여넣기
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress파일 저장 후 사이트에 접속하여 오류가 해결되었는지 확인합니다. 해결되었다면 워드프레스 관리자 화면 → 설정 → 고유주소에서 저장 버튼을 클릭하면 .htaccess가 자동으로 재생성됩니다.
3단계: PHP 메모리 한도 늘리기
카페24에서는 나의 서비스 관리 메뉴에서 PHP 버전과 서버 환경을 직접 변경할 수 있습니다. PHP 버전이 낮을 경우 메모리 부족 문제가 함께 발생하는 경우가 많으므로 버전 업그레이드도 함께 진행하시기 바랍니다.
- 카페24 호스팅 제어판(hosting.cafe24.com) 로그인
- 상단 메뉴에서 나의서비스관리 클릭
- 호스팅관리 → 연장/변경/추가옵션 → 변경신청 클릭
- 서버환경 변경 항목에서 PHP 버전을 최신 버전(PHP 8.2 이상)으로 선택
- 변경신청 버튼 클릭 후 약 30분 대기
또는 워드프레스 루트의 wp-config.php 파일에 다음 코드를 추가할 수도 있습니다.
define( 'WP_MEMORY_LIMIT', '256M' );위 코드는 <?php 태그 바로 아래 줄에 추가합니다.
4단계: 플러그인 및 테마 충돌 확인
관리자 화면에 접근이 불가능한 경우 FTP를 이용하여 플러그인을 일괄 비활성화합니다.
- FTP 파일 관리자로 접속
- wp-content/plugins 폴더로 이동
- 폴더 이름을
plugins→plugins_disabled로 변경 - 사이트에 접속하여 오류 해결 여부 확인
- 해결된 경우 폴더 이름을 다시
plugins로 변경 - 관리자 화면 → 플러그인에서 하나씩 활성화하며 원인 플러그인 파악
관리자 화면 접근이 가능하다면 플러그인 메뉴에서 전체 선택 후 비활성화를 적용한 다음, 하나씩 다시 활성화하며 원인을 찾습니다.
5단계: 테마 기본 테마로 전환
플러그인을 모두 비활성화해도 오류가 지속된다면 테마가 원인일 수 있습니다.
- FTP로 wp-content/themes 폴더 접속
- 현재 사용 중인 테마 폴더명 변경 (예:
my-theme→my-theme_backup) - 워드프레스가 자동으로 기본 테마인 Twenty Twenty-Four로 전환됨
- 사이트 접속 확인
6단계: 워드프레스 코어 파일 재업로드
위 방법으로도 해결되지 않는다면, 워드프레스 공식 사이트에서 최신 버전을 다운로드하여 핵심 파일을 재업로드합니다.
- WordPress.org에서 최신 버전 다운로드
- 압축 해제 후 wp-admin, wp-includes 폴더를 FTP로 덮어쓰기
- wp-content 폴더와 wp-config.php는 덮어쓰지 않도록 주의
- 루트의
*.php파일들도 함께 교체
500 에러 예방 방법
- 정기적인 백업: 업데이트 전 반드시 전체 백업을 진행합니다
- PHP 버전 관리: 워드프레스 권장 PHP 버전(8.1 이상)을 유지합니다
- 플러그인 관리: 사용하지 않는 플러그인은 삭제합니다
- 스테이징 환경: 주요 업데이트는 테스트 환경에서 먼저 검증합니다
- 보안 플러그인: Wordfence 등을 이용하여 파일 변경 사항을 모니터링합니다
자주 묻는 질문 (FAQ)
Q. 500 에러가 갑자기 발생했는데 아무것도 변경하지 않았습니다.
플러그인이나 테마가 자동 업데이트된 경우 충돌이 발생할 수 있습니다. 워드프레스 자동 업데이트 설정을 확인하고, 에러 로그에서 최근 변경 사항을 추적합니다.
Q. 관리자 화면은 되는데 특정 페이지에서만 500 에러가 납니다.
해당 페이지에 연결된 특정 플러그인이나 숏코드가 문제일 가능성이 높습니다. 해당 페이지 편집 화면에서 플러그인 블록을 하나씩 제거하여 원인을 찾습니다.
Q. 카페24 고객센터에 문의해야 하나요?
위 방법으로 해결되지 않는 경우, 카페24 고객센터에 에러 로그와 함께 문의하시기 바랍니다. 서버 설정 문제인 경우 호스팅사에서만 해결할 수 있는 경우도 있습니다.
정리
워드프레스 500 Internal Server Error는 원인이 다양하지만, 대부분 .htaccess 초기화 → PHP 메모리 증가 → 플러그인/테마 비활성화 순서로 점검하면 해결됩니다. 카페24 호스팅 제어판의 PHP 구성 기능을 적극 활용하시기 바랍니다.
다음 글에서는 502 Bad Gateway 에러의 원인과 해결 방법을 자세히 안내합니다. 서버 간 통신 문제로 발생하는 이 오류 역시 카페24 환경에서의 해결 방법을 함께 살펴보겠습니다.
