이 가이드에서는 카페24 호스팅 환경을 기준으로 504 에러의 주요 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. 504 에러란 무엇인가?
• 2. 504 에러의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 504 에러 예방 방법
• 5. 자주 묻는 질문 (FAQ)

1. 504 에러란 무엇인가?

HTTP 504 Gateway Timeout은 게이트웨이(웹 서버)가 업스트림 서버(PHP, 데이터베이스 등)로부터 지정된 시간 내에 응답을 받지 못할 때 발생하는 오류 코드입니다. 쉽게 말해
서버가 작업을 완료하지 못하고 시간이 초과된 상황입니다.

주요 증상

• 페이지가 로딩 중 멈추다가 504 에러 화면으로 전환됩니다.
• 워드프레스 플러그인 업데이트, 테마 설치, 이미지 대량 업로드 중 에러가 자주 발생합니다.
• WooCommerce 주문 처리나 대용량 데이터 임포트 중에도 나타납니다.
• 사이트의 특정 페이지에서만 반복적으로 발생하기도 합니다.

503 에러와의 차이점

2. 504 에러의 주요 원인 5가지

원인 1 — PHP 실행 시간(max_execution_time) 초과

가장 흔한 원인입니다. PHP 스크립트가 서버에 설정된 최대 실행 시간(기본값 30~60초) 안에 작업을 완료하지 못하면 서버가 연결을 강제로 끊습니다. 대용량 파일 처리, 플러그인 업데이트,
WooCommerce 대량 주문 처리 시 자주 발생합니다.

원인 2 — 느린 데이터베이스 쿼리

최적화되지 않은 플러그인이나 누적된 데이터로 인해 데이터베이스 쿼리 처리 시간이 길어지면 504 에러가 발생합니다. 특히 댓글, 주문, 회원 데이터가 많이 쌓인 사이트에서 자주 나타납니다.

원인 3 — 무거운 플러그인

서버 리소스를 과도하게 사용하는 플러그인(특히 SEO 분석, 백업, 이미지 최적화 플러그인)이 504 에러를 유발하는 경우가 있습니다.

원인 4 — CDN 또는 프록시 서버 설정 오류

Cloudflare 등 CDN의 타임아웃 설정이 서버 처리 시간보다 짧게 설정된 경우, CDN이 먼저 504 에러를 반환합니다.

원인 5 — 외부 API 응답 지연

결제 게이트웨이, 지도 API, 소셜 로그인 등 외부 서비스 API가 느리게 응답하면 PHP 스크립트가 기다리다 타임아웃됩니다.

3. 카페24 호스팅에서 해결 방법

1단계 — 플러그인 전체 비활성화

특정 플러그인이 원인인지 먼저 확인합니다.

1. 카페24 파일 관리자 또는 FTP로 접속합니다.
2. /wp-content/plugins/ 폴더명을 plugins_disabled로 임시 변경합니다.
3. 사이트에 접속하여 504 에러가 해결되는지 확인합니다.
4. 해결되면 폴더명을 복구하고 플러그인을 하나씩 활성화하며 원인 플러그인을 찾습니다.

2단계 — 카페24에서 PHP 실행 시간 늘리기

카페24 호스팅에서는 관리자 페이지에서 직접 PHP 설정을 변경할 수 있습니다.

1. 카페24 호스팅 관리자 접속
2. [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]
3. max_execution_time을 300 (초)으로 변경합니다.
4. memory_limit을 512M으로 변경합니다.
5. [저장하기]를 클릭하고 사이트를 다시 확인합니다.

3단계 — wp-config.php에서 PHP 시간 설정

카페24 PHP 설정이 변경되지 않거나 즉시 적용이 필요한 경우, wp-config.php 파일을 직접 수정합니다.

1. 카페24 파일 관리자에서 WordPress 루트의 wp-config.php를 편집합니다.
2. /* That's all, stop editing! */ 줄 바로 위에 아래 코드를 추가합니다.

// PHP 실행 시간 300초로 늘리기
set_time_limit(300);
define('WP_MEMORY_LIMIT', '512M');
define('WP_MAX_MEMORY_LIMIT', '512M');

4단계 — .htaccess에 타임아웃 설정 추가

WordPress 루트의 .htaccess 파일에 아래 코드를 추가하는 방법도 있습니다.

php_value max_execution_time 300
php_value max_input_time 300

5단계 — CDN 타임아웃 설정 확인

Cloudflare를 사용 중이라면 Cloudflare 대시보드에서 타임아웃 설정을 확인합니다.

• Cloudflare 대시보드 → Speed → Optimization → Protocol Optimization
• 무료 플랜의 경우 100초 타임아웃이 적용됩니다. 이보다 긴 작업은 Cloudflare를 임시 비활성화(Development Mode)하고 테스트합니다.

6단계 — 데이터베이스 쿼리 최적화

불필요한 데이터가 많이 쌓인 경우 데이터베이스를 정리하면 쿼리 속도가 향상됩니다.

• WP-Optimize 플러그인을 설치하고 데이터베이스 최적화를 실행합니다.
• 삭제된 포스트, 리비전, 스팸 댓글, 만료된 트랜지언트 데이터를 제거합니다.

4. 504 에러 예방 방법

• PHP 실행 시간 사전 설정: 카페24 PHP 설정에서 max_execution_time을 초기부터 120~300초로 설정해 두면 대부분의 504 에러를
  예방할 수 있습니다.
• 플러그인 관리: 사용하지 않는 플러그인은 삭제하고, 리소스를 많이 사용하는 플러그인은 가벼운 대안으로 교체합니다.
• 정기적인 DB 최적화: 월 1회 데이터베이스를 정리하여 쿼리 속도를 유지합니다.
• 캐시 플러그인 활용: 페이지 캐시를 사용하면 PHP가 매번 실행되지 않아 504 에러 발생 빈도를 크게 줄일 수 있습니다.
• 업데이트는 비트래픽 시간에: 대용량 플러그인 업데이트나 파일 임포트 작업은 방문자가 적은 새벽 시간에 진행하시기 바랍니다.

5. 자주 묻는 질문 (FAQ)

Q. 504 에러가 특정 페이지에서만 발생해요.

특정 페이지에서만 발생한다면 그 페이지와 연결된 플러그인이나 대용량 쿼리가 원인일 가능성이 높습니다. Query Monitor 플러그인을 설치하여 해당 페이지의 느린 쿼리를 확인하시기 바랍니다.

Q. 504 에러와 503 에러는 어떻게 다른가요?

503은 서버가 서비스 불가 상태(과부하, 유지보수), 504는 서버가 지정된 시간 내에 응답을 받지 못한 경우(시간 초과)입니다. 504는 주로 PHP 실행 시간 초과나 느린 데이터베이스 쿼리가
원인입니다.

Q. 카페24에서 PHP 실행 시간을 늘리려면?

카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]에서
max_execution_time을 300초 이상으로 변경합니다. 또는 .htaccess 파일에
php_value max_execution_time 300을 추가합니다.

Q. 504 에러가 해결됐다 재발해요.

일시적으로 해결됐다 재발하는 경우 근본 원인이 해결되지 않은 것입니다. Query Monitor로 느린 쿼리를 찾거나, 원인 플러그인을 찾아 교체하는 것이 필요합니다. 카페24
고객센터(1588-3284)에 서버 로그 분석을 요청하실 수도 있습니다.

정리 — 504 에러, 이렇게 해결하세요

504 Gateway Timeout 에러는 대부분 PHP 실행 시간 연장, 플러그인 비활성화, 데이터베이스 최적화로 해결됩니다. 카페24 호스팅에서는 PHP 설정
메뉴에서 직접 max_execution_time을 늘릴 수 있어 비교적 간단하게 해결할 수 있습니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 500 Internal Server
  Error 해결 가이드
• 워드프레스 503 Service Unavailable 해결
  가이드

이 가이드에서는 카페24 호스팅 환경을 기준으로 503 에러의 주요 원인과 단계별 해결 방법을 안내합니다.

목차

• 1. 503 에러란 무엇인가?
• 2. 503 에러의 주요 원인 5가지
• 3. 카페24 호스팅에서 해결 방법
• 4. 503 에러 예방 방법
• 5. 자주 묻는 질문 (FAQ)

1. 503 에러란 무엇인가?

HTTP 503 Service Unavailable은 서버가 현재 요청을 처리할 수 없는 상태임을 알리는 응답 코드입니다. 서버 자체는 살아있지만, 과부하나 유지보수 상태로 인해 요청 처리를
거부할 때 발생합니다.

주요 증상

• 사이트 전체가 접속되지 않고 503 메시지만 표시됩니다.
• 워드프레스 관리자 화면(wp-admin)도 함께 열리지 않는 경우가 많습니다.
• 새로고침하면 가끔 접속되다가 다시 에러가 나타나는 경우도 있습니다.
• 카페24 호스팅의 경우 “약정 트래픽을 초과하였습니다” 메시지가 함께 표시되기도 합니다.

502 에러와의 차이점

2. 503 에러의 주요 원인 5가지

원인 1 — 카페24 일일 트래픽 초과

카페24 호스팅은 요금제별로 일일 약정 트래픽이 정해져 있습니다. 트래픽이 한도를 초과하면 서버가 자동으로 외부 접속을 차단하며 503 에러 화면을 표시합니다. 특히 인기 있는 글이 SNS에
공유되거나 검색 노출이 갑자기 늘어날 때 자주 발생합니다.

원인 2 — 워드프레스 유지보수 모드 고착

워드프레스 코어, 플러그인, 테마를 업데이트하는 동안 루트 디렉터리에 .maintenance 파일이 자동 생성됩니다. 업데이트가 정상 완료되면 자동으로 삭제되어야 하지만,
업데이트 도중 오류가 발생하면 파일이 남아 있어 지속적인 503 에러를 유발합니다.

원인 3 — 서버 과부하 (리소스 부족)

동시 접속자가 급격히 증가하거나, 특정 플러그인이 많은 서버 리소스를 소비할 경우 서버가 새 요청을 처리할 수 없게 됩니다. 공유 호스팅 환경에서는 다른 사이트의 과부하가 영향을 미치기도 합니다.

원인 4 — 캐시 플러그인 오류

WP Fastest Cache, W3 Total Cache 등의 캐시 플러그인이 업데이트 또는 설정 변경 후 오류를 일으키며 503 에러를 발생시키는 경우가 있습니다.

원인 5 — PHP 설정 한도 초과

PHP 메모리 한도(memory_limit) 또는 동시 실행 프로세스 수가 제한에 도달하면 서버가 새 요청을 거부합니다.

3. 카페24 호스팅에서 해결 방법

1단계 — .maintenance 파일 삭제

가장 먼저 확인해야 할 사항입니다. 카페24 호스팅 관리자의 파일 관리자 또는 FTP를 통해 확인합니다.

1. 카페24 호스팅 관리자 접속 → [나의 서비스 관리] → [호스팅 관리] → [파일 관리자]
2. 워드프레스가 설치된 루트 디렉터리(보통 public_html/)로 이동합니다.
3. .maintenance 파일이 있으면 선택하여 삭제합니다.
4. 삭제 후 사이트에 다시 접속합니다.

주의: .maintenance 파일은 점(.)으로 시작하는 숨김 파일입니다. 파일 관리자에서 “숨김 파일 보기” 옵션을 활성화해야 보입니다.

2단계 — 카페24 트래픽 사용량 확인

카페24 호스팅에서는 트래픽 초과가 503 에러의 가장 흔한 원인입니다. 아래 경로에서 확인하시기 바랍니다.

1. 카페24 호스팅 관리자 접속
2. [나의 서비스 관리] → [호스팅 관리] → [트래픽 사용량] 확인
3. 일일 트래픽이 한도의 100%에 도달해 있다면 트래픽 초과가 원인입니다.

해결 방법:

• 단기: 다음날(자정 이후) 트래픽이 초기화될 때까지 대기합니다.
• 즉시 해결: 카페24 고객센터(1588-3284) 또는 관리자 페이지에서 트래픽 추가 구매를 신청합니다.
• 근본 해결: 더 높은 트래픽 한도의 호스팅 요금제로 업그레이드합니다.

3단계 — 플러그인 전체 비활성화

트래픽 문제가 아니라면 플러그인 충돌을 의심합니다. 관리자 화면이 열리지 않으므로 FTP를 사용합니다.

1. 카페24 파일 관리자 또는 FTP로 접속합니다.
2. /wp-content/plugins/ 폴더명을 plugins_disabled로 임시 변경합니다.
3. 사이트 접속을 시도합니다. 접속되면 플러그인 충돌이 원인입니다.
4. 폴더명을 원래대로 복구한 후 플러그인을 하나씩 활성화하며 원인을 찾습니다.

4단계 — PHP 메모리 한도 늘리기

카페24 호스팅에서 PHP 설정을 변경하는 방법입니다.

1. 카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리] → [PHP 설정]
2. memory_limit를 256M 또는 512M으로 변경합니다.
3. 또는 WordPress 루트의 wp-config.php 파일에 아래 코드를 추가합니다.

define('WP_MEMORY_LIMIT', '512M');
define('WP_MAX_MEMORY_LIMIT', '512M');

5단계 — 캐시 전체 삭제

관리자 화면이 열린다면 캐시 플러그인의 전체 캐시를 삭제합니다.

• WP Fastest Cache: [WP Fastest Cache] → [캐시 삭제] → [모든 캐시 삭제]
• W3 Total Cache: [Performance] → [Dashboard] → [empty all caches]

관리자 화면이 열리지 않는 경우 FTP로 /wp-content/cache/ 폴더 내 파일을 모두 삭제합니다.

4. 503 에러 예방 방법

• 캐시 플러그인 적극 활용: 캐시를 통해 서버 리소스 소비를 줄이면 트래픽 급증 시에도 서버 부하를 낮출 수 있습니다.
• CDN 연결: Cloudflare 등 CDN을 연결하면 트래픽의 상당 부분을 CDN이 처리하여 호스팅 서버 부하를 크게 줄입니다.
• 트래픽 모니터링: 카페24 호스팅 관리자에서 월별 트래픽 사용 추이를 정기적으로 확인하고, 한도의 80%에 도달하면 업그레이드를 준비합니다.
• 이미지 최적화: 이미지 파일 크기를 줄이면 동일한 트래픽 한도로 더 많은 방문자를 수용할 수 있습니다. ShortPixel, EWWW Image
  Optimizer 등을 활용하시기 바랍니다.
• 업데이트 전 백업: 플러그인, 테마, 코어 업데이트 전 반드시 전체 백업을 진행하여 업데이트 실패 시 빠르게 복구할 수 있도록 준비합니다.

5. 자주 묻는 질문 (FAQ)

Q. 503 에러가 발생했는데 관리자 화면도 안 열려요.

FTP로 서버에 직접 접속해야 합니다. 카페24 호스팅 관리자 → [FTP 관리] → [파일 관리자]에서
.maintenance 파일 삭제를 먼저 시도하세요. 그래도 해결되지 않으면 plugins 폴더명을 변경하여 플러그인을 비활성화합니다.

Q. 카페24에서 트래픽 초과로 503 에러가 났어요. 해결법은?

카페24 호스팅 관리자 → [나의 서비스 관리] → [호스팅 관리]에서 트래픽 사용량을 확인합니다. 초과 시 트래픽 추가 구매 또는 더
높은 사양의 호스팅으로 업그레이드해야 합니다. 자정 이후에는 일일 트래픽이 자동 초기화됩니다.

Q. 503 에러와 502 에러의 차이는 무엇인가요?

502(Bad Gateway)는 서버 간 통신 실패, 503(Service Unavailable)은 서버 자체가 일시적으로 서비스 불가 상태입니다. 503은 트래픽 초과나 유지보수 모드처럼
일시적인 원인인 경우가 많습니다.

Q. 잠깐 기다리면 저절로 해결되기도 하나요?

서버 일시 과부하로 발생한 경우에는 수 분 내에 자동으로 해결되기도 합니다. 그러나 트래픽 초과나 .maintenance 파일 문제라면 직접 조치를 취해야 합니다. 15분이 지나도 해결되지 않으면
위 해결 방법을 순서대로 점검하시기 바랍니다.

정리 — 503 에러, 이렇게 해결하세요

503 Service Unavailable 에러는 대부분 .maintenance 파일 삭제, 트래픽 초과 확인, 플러그인 비활성화 세 가지 방법으로 해결됩니다.
카페24 호스팅 환경에서는 특히 트래픽 초과가 가장 흔한 원인이므로, 먼저 트래픽 사용량을 확인하시기 바랍니다.

다른 에러 해결이 필요하시다면 아래 가이드를 참고하시기 바랍니다.

• 워드프레스 에러 해결 완벽 가이드 (전체 에러 총정리)
• 워드프레스 500 Internal Server
  Error 해결 가이드
• 워드프레스 502 Bad Gateway 해결 가이드

워드프레스 502 Bad Gateway 해결 방법 완벽 가이드

워드프레스 사이트에 접속하려는데 “502 Bad Gateway” 메시지가 나타난다면, 서버 간 통신에 문제가 생긴 상황입니다. 500 에러와 달리 502 에러는 웹 서버와 상위(업스트림) 서버
사이의 연결 문제로 발생합니다. 이번 글에서는 502 에러의 원인과 카페24 호스팅 환경에서 단계별로 해결하는 방법을 안내합니다.

502 Bad Gateway란?

502 Bad Gateway는 게이트웨이 역할을 하는 서버가 업스트림(상위) 서버로부터 유효하지 않은 응답을 받았을 때 발생하는 HTTP 상태 코드입니다. 공유 호스팅 환경에서는 서버 과부하,
CDN 오작동, DNS 전파 지연 등으로 자주 발생합니다.

주요 증상

• 사이트 전체에 “502 Bad Gateway” 메시지가 표시됨
• 관리자 화면과 프론트엔드 모두 접속 불가
• 일정 시간이 지나면 자동으로 해결되는 경우가 있음
• 특정 국가·지역에서만 오류가 발생하는 경우(CDN 문제)
• 도메인을 최근에 이전하거나 변경한 직후 발생

502 에러의 주요 원인 4가지

1. CDN(콘텐츠 전송 네트워크) 충돌

CDN 설정이 잘못되거나 CDN 서버에 일시적인 장애가 발생해 원본 서버와의 통신이 끊길 때 502 에러가 발생합니다. 카페24 무료 CDN을 사용 중인 경우 특히 주의가 필요합니다.

2. DNS 전파 지연 또는 설정 오류

도메인 이전이나 DNS 레코드 변경 후 최대 24~48시간 동안 전파가 완료되지 않아 서버 간 통신이 불안정해집니다. 네임서버나 A 레코드 값이 잘못 설정된 경우에도 동일한 증상이 나타납니다.

3. 서버 과부하 및 타임아웃

방문자 급증이나 무거운 플러그인 실행으로 서버 리소스가 고갈되면 업스트림 서버가 응답 시간을 초과하여 502가 반환됩니다.

4. 캐시·프록시 플러그인 오작동

WP Rocket, W3 Total Cache 등 캐시 플러그인이 업스트림 서버와 충돌하거나 오래된 캐시 파일이 올바르지 않은 응답을 전달하는 경우입니다.

카페24 호스팅에서 502 에러 해결 방법

1단계: 브라우저 캐시 강제 초기화

가장 먼저 브라우저 캐시가 문제는 아닌지 확인합니다. 브라우저가 오래된 502 응답을 캐시로 저장해 계속 보여주는 경우가 있습니다.

• Windows: Ctrl + Shift + Delete → 캐시/쿠키 삭제 후 재접속
• Mac: Cmd + Shift + Delete → 캐시/쿠키 삭제 후 재접속
• 비공개(시크릿) 모드로 접속하여 오류 재현 여부 확인
• 다른 기기 또는 모바일 데이터로 접속 시도

2단계: CDN 설정 임시 비활성화

카페24 무료 CDN을 사용 중이라면 CDN을 임시로 중지하고 오류가 해결되는지 확인합니다.

1. 카페24 호스팅 제어판(hosting.cafe24.com)
   로그인
2. 나의서비스관리 → 호스팅관리 → 연장/변경/추가옵션 클릭
3. 무료 CDN 신청 항목에서 CDN 서비스 상태 확인
4. CDN이 활성화 상태라면 임시로 해제 또는 중지 처리
5. 30분 후 사이트 접속 재확인

오류가 해결된다면 CDN 설정이 원인입니다. CDN을 다시 활성화한 뒤 워드프레스 관리자 화면 → 설정 → 캐시 플러그인 설정에서 CDN URL이 올바르게 입력되어
있는지 확인합니다.

3단계: DNS 설정 점검

최근 도메인을 이전하거나 DNS 레코드를 변경한 경우 설정을 점검합니다.

1. 카페24 호스팅 제어판 로그인
2. 나의서비스관리 → 도메인 관리 → DNS 관리 클릭
3. A 레코드: 도메인이 올바른 서버 IP를 가리키고 있는지 확인
4. CNAME: www 도메인이 루트 도메인을 올바르게 가리키는지 확인
5. 네임서버: 카페24 네임서버(ns1.cafe24.com, ns2.cafe24.com)로 설정되어 있는지 확인

DNS 변경 직후라면 전파가 완료될 때까지 최대 48시간이 소요됩니다. 전파 상태는 DNSChecker.org에서 확인하실 수 있습니다.

4단계: 캐시 및 프록시 플러그인 비활성화

캐시 플러그인이 충돌하는 경우 FTP로 접속하여 해당 플러그인을 비활성화합니다.

1. FTP 클라이언트(FileZilla 등) 또는 카페24 파일 관리자로 접속
2. wp-content/plugins 폴더로 이동
3. 캐시 관련 플러그인 폴더명 변경
   • wp-rocket → wp-rocket_disabled
   • w3-total-cache → w3-total-cache_disabled
4. 사이트 접속 확인
5. 해결된 경우 캐시 플러그인 설정을 새로 구성하거나 대체 플러그인으로 교체

5단계: 카페24 서버 점검 여부 확인

위 방법으로도 해결되지 않는다면, 카페24 서버 자체에 장애가 발생했을 가능성이 있습니다.

• 카페24 호스팅 고객센터(help.cafe24.com) →
  공지사항 확인
• 서버 점검 공지가 있는지 확인
• 카페24 1:1 문의로 현재 서버 상태 문의
• 서버 문제가 아니라면 카페24 지원팀에 서버 로그 분석 요청

502 에러 예방 방법

• CDN 연동 점검: CDN URL과 워드프레스 사이트 URL이 일치하는지 정기적으로 확인합니다
• DNS TTL 관리: 도메인 이전 전 TTL 값을 낮춰 전파 속도를 높입니다
• 서버 리소스 모니터링: 방문자 급증에 대비하여 호스팅 상품 업그레이드를 검토합니다
• 캐시 플러그인 최신화: 캐시 플러그인을 항상 최신 버전으로 유지합니다
• 업타임 모니터링: UptimeRobot 등을 이용하여 502 발생 시 즉시 알림을 받습니다

자주 묻는 질문 (FAQ)

Q. 502 에러가 잠깐 나타났다가 사라지는 이유는 무엇인가요?

서버 부하가 일시적으로 높아졌다가 낮아지거나, CDN 서버가 자체 복구되는 경우 자연스럽게 해결됩니다. 반복적으로 발생한다면 서버 리소스 업그레이드 또는 캐시 플러그인 설정을 재검토해야 합니다.

Q. 502와 503 에러는 어떻게 다른가요?

502는 서버 간 통신 오류로 업스트림 서버에서 잘못된 응답이 온 경우이고, 503은 서버 자체가 일시적으로 서비스를 제공할 수 없는 상태(과부하, 유지보수 모드)를 의미합니다.

Q. 카페24에서 네임서버 변경 후 502 에러가 납니다.

DNS 전파 지연으로 인해 발생하는 일시적인 현상입니다. 변경 후 최대 48시간 동안 간헐적으로 502 에러가 발생할 수 있습니다. DNSChecker.org에서 전파 현황을 확인하며 기다리시기
바랍니다.

정리

워드프레스 502 Bad Gateway 에러는 대부분 CDN 충돌 → DNS 설정 점검 → 캐시 플러그인 비활성화 순서로 점검하면 해결됩니다. 특히 카페24 무료
CDN과 캐시 플러그인을 함께 사용하는 경우 설정 충돌이 자주 발생하므로 주의가 필요합니다.

다음 글에서는 503 Service Unavailable 에러의 원인과 해결 방법을 안내합니다. 서버 과부하와 유지보수 모드로 인한 이 오류 역시 카페24 환경에서의
해결 방법을 함께 살펴보겠습니다.

워드프레스 사이트를 운영하다 보면 갑자기 흰 화면이나 “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 손상이 의심되는 경우 다음 방법으로 초기화합니다.

1. 카페24 호스팅 제어판 → FTP 파일 관리자 접속
2. 워드프레스 루트 디렉토리(예: /www/ 또는 /public_html/)로 이동
3. .htaccess 파일을 선택하여 이름을 .htaccess_backup으로 변경
4. 새 .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 버전이 낮을 경우 메모리 부족 문제가 함께 발생하는 경우가 많으므로 버전 업그레이드도 함께 진행하시기 바랍니다.

1. 카페24 호스팅 제어판(hosting.cafe24.com) 로그인
2. 상단 메뉴에서 나의서비스관리 클릭
3. 호스팅관리 → 연장/변경/추가옵션 → 변경신청 클릭
4. 서버환경 변경 항목에서 PHP 버전을 최신 버전(PHP 8.2 이상)으로 선택
5. 변경신청 버튼 클릭 후 약 30분 대기

또는 워드프레스 루트의 wp-config.php 파일에 다음 코드를 추가할 수도 있습니다.

define( 'WP_MEMORY_LIMIT', '256M' );

위 코드는 <?php 태그 바로 아래 줄에 추가합니다.

4단계: 플러그인 및 테마 충돌 확인

관리자 화면에 접근이 불가능한 경우 FTP를 이용하여 플러그인을 일괄 비활성화합니다.

1. FTP 파일 관리자로 접속
2. wp-content/plugins 폴더로 이동
3. 폴더 이름을 plugins → plugins_disabled로 변경
4. 사이트에 접속하여 오류 해결 여부 확인
5. 해결된 경우 폴더 이름을 다시 plugins로 변경
6. 관리자 화면 → 플러그인에서 하나씩 활성화하며 원인 플러그인 파악

관리자 화면 접근이 가능하다면 플러그인 메뉴에서 전체 선택 후 비활성화를 적용한 다음, 하나씩 다시 활성화하며 원인을 찾습니다.

5단계: 테마 기본 테마로 전환

플러그인을 모두 비활성화해도 오류가 지속된다면 테마가 원인일 수 있습니다.

1. FTP로 wp-content/themes 폴더 접속
2. 현재 사용 중인 테마 폴더명 변경 (예: my-theme → my-theme_backup)
3. 워드프레스가 자동으로 기본 테마인 Twenty Twenty-Four로 전환됨
4. 사이트 접속 확인

6단계: 워드프레스 코어 파일 재업로드

위 방법으로도 해결되지 않는다면, 워드프레스 공식 사이트에서 최신 버전을 다운로드하여 핵심 파일을 재업로드합니다.

1. WordPress.org에서 최신 버전 다운로드
2. 압축 해제 후 wp-admin, wp-includes 폴더를 FTP로 덮어쓰기
3. wp-content 폴더와 wp-config.php는 덮어쓰지 않도록 주의
4. 루트의 *.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 환경에서의 해결 방법을 함께 살펴보겠습니다.