워드프레스 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 환경에서의
해결 방법을 함께 살펴보겠습니다.

이 가이드는 워드프레스에서 자주 발생하는 주요 에러 코드별 원인과 해결 방법을 한 곳에 정리한 허브 페이지입니다. 에러 유형을 빠르게 파악하고, 각 에러별 상세
가이드로 연결됩니다.

목차

• 1. 워드프레스 에러가 발생하는 이유
• 2. 에러 발생 시 가장 먼저 해야 할 일
• 3. 에러 코드 빠른 분류표
• 4. 서버 오류 (5xx) 해결법
• 5. 접근 권한 오류 (4xx) 해결법
• 6. PHP 및 코어 오류 해결법
• 7. 에러 없는 워드프레스 유지하는 법
• 8. 자주 묻는 질문 (FAQ)

1. 워드프레스 에러가 발생하는 이유

워드프레스 에러의 원인은 크게 네 가지로 나눌 수 있습니다. 에러가 발생했을 때 이 네 가지 영역을 순서대로 점검하면 대부분의 문제를 해결할 수 있습니다.

• 플러그인·테마 충돌: 새로 설치하거나 업데이트한 플러그인, 테마가 기존 환경과 충돌하는 가장 흔한 원인입니다.
• 서버·호스팅 문제: PHP 메모리 한도 초과, 서버 과부하, 디스크 용량 부족 등 호스팅 환경 설정과 관련된 문제입니다.
• 파일 권한 및 설정 오류: .htaccess 파일 손상, 파일/폴더 권한(Permission) 설정 오류가 다양한 에러를 유발합니다.
• PHP 버전 비호환: 워드프레스 코어, 플러그인, 테마가 현재 서버의 PHP 버전과 맞지 않을 경우 치명적인 오류가 발생합니다.

에러가 발생하면 당황하지 말고, 원인을 좁혀가는 순서로 점검하는 것이 중요합니다. 아래 디버그 방법부터 확인해 보시기 바랍니다.

2. 에러 발생 시 가장 먼저 해야 할 일

에러가 발생했을 때 무작정 시도하기보다, 아래 순서를 따라 진행하면 훨씬 빠르게 해결할 수 있습니다.

1단계 — 디버그 모드 활성화

워드프레스 wp-config.php 파일에 아래 코드를 추가하면 정확한 오류 메시지를 확인할 수 있습니다.

define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

설정 후 /wp-content/debug.log 파일에서 상세 오류 내용을 확인하시기 바랍니다.

2단계 — 최근 변경 사항 확인

• 에러 발생 직전에 설치하거나 업데이트한 플러그인·테마가 있다면 먼저 비활성화합니다.
• 워드프레스 코어 업데이트를 진행했다면 wp-content/plugins 폴더를 FTP로 임시 이름 변경하여 전체 비활성화를 시도합니다.

3단계 — 호스팅 서비스 상태 확인

카페24 호스팅의 경우 카페24 고객센터(help.cafe24.com)에서 서비스 공지사항을 확인하거나, 호스팅 관리 페이지에서 서버 상태를 점검합니다.

3. 에러 코드 빠른 분류표

에러 코드를 확인하면 원인의 방향을 빠르게 좁힐 수 있습니다. 아래 분류표를 참고하여 해당 에러의 상세 가이드로 이동하시기 바랍니다.

4. 서버 오류 (5xx) 해결법

5xx 계열 에러는 서버 측 문제로 발생합니다. 서버 설정, 리소스, 플러그인 충돌이 주요 원인입니다.

500 Internal Server Error — 가장 흔한 서버 오류

워드프레스에서 가장 자주 발생하는 에러입니다. 원인이 다양하여 단계별 점검이 필요합니다.

• 주요 원인: .htaccess 파일 손상, 플러그인 충돌, PHP 메모리 한도 초과, 파일 권한 오류
• 빠른 해결법: 플러그인 전체 비활성화 → .htaccess 재생성 → PHP 메모리 512M으로 증가

→ 워드프레스 500 에러 완벽 해결 가이드 (단계별
상세 방법 확인)

502 Bad Gateway — 서버 간 통신 단절

웹 서버와 업스트림 서버(PHP-FPM, 백엔드) 사이의 통신이 실패할 때 발생합니다.

• 주요 원인: PHP-FPM 프로세스 과부하, CDN 설정 오류, DNS 전파 지연
• 빠른 해결법: CDN 임시 비활성화 → DNS 설정 확인 → 호스팅 서버 재시작 요청

→ 워드프레스 502 에러 완벽 해결 가이드

503 Service Unavailable — 서버 과부하

서버가 일시적으로 요청을 처리할 수 없는 상태입니다. 주로 트래픽 급증이나 유지보수 모드 활성화 시 발생합니다.

• 주요 원인: 트래픽 급증으로 인한 서버 과부하, 워드프레스 업데이트 중 유지보수 모드 고착, 메모리 부족
• 빠른 해결법: FTP로 /wp-content/.maintenance 파일 삭제 → 캐시 플러그인 비활성화 → 호스팅 리소스 확인

504 Gateway Timeout — 응답 시간 초과

서버가 지정된 시간 안에 처리를 완료하지 못할 때 발생합니다. 대용량 작업이나 느린 플러그인이 원인인 경우가 많습니다.

• 주요 원인: 복잡한 쿼리로 인한 PHP 실행 시간 초과, 외부 API 응답 지연, 서버 리소스 부족
• 빠른 해결법: wp-config.php에 set_time_limit(300) 추가 → 호스팅 PHP 실행 시간
  연장 요청 → 불필요한 플러그인 비활성화

5. 접근 권한 오류 (4xx) 해결법

4xx 계열 에러는 클라이언트(브라우저)의 요청 자체에 문제가 있거나, 서버가 접근을 거부할 때 발생합니다.

400 Bad Request — 잘못된 요청

브라우저가 서버에 잘못된 형식의 요청을 보낼 때 발생합니다. 쿠키나 캐시 문제인 경우가 많습니다.

• 주요 원인: 손상된 브라우저 쿠키, 잘못된 URL 형식, HTTP 헤더 오류
• 빠른 해결법: 브라우저 쿠키·캐시 삭제 → 다른 브라우저에서 접속 시도 → WordPress 쿠키 설정 확인

→ 워드프레스 400 에러 해결 가이드

403 Forbidden — 접근 금지

서버가 요청 자체는 이해했지만 접근 권한이 없어 거부하는 경우입니다.

• 주요 원인: 파일 권한 오류(폴더: 755, 파일: 644 필요), .htaccess의 잘못된 접근 제한 설정, 보안 플러그인의 IP 차단
• 빠른 해결법: FTP로 파일 권한을 755/644로 변경 → .htaccess 파일 재생성 → 보안 플러그인 임시 비활성화

404 Not Found — 페이지를 찾을 수 없음

워드프레스에서 404 에러는 주로 퍼머링크 설정 문제로 발생합니다.

• 주요 원인: 퍼머링크 구조 깨짐, .htaccess 파일 손상, 페이지/포스트 삭제
• 빠른 해결법: 워드프레스 관리자 → [설정] → [퍼머링크] → [변경사항 저장] 클릭 (퍼머링크 재생성)

429 Too Many Requests — 요청 횟수 초과

짧은 시간 안에 너무 많은 요청이 들어올 때 서버가 요청을 거부합니다. 봇 트래픽이나 자동화 스크립트가 원인인 경우가 많습니다.

• 주요 원인: 악성 봇의 과도한 크롤링, 로그인 무차별 대입 공격, 플러그인의 과도한 API 호출
• 빠른 해결법: 로그인 시도 제한 플러그인 설치 → Wordfence 등 보안 플러그인으로 봇 차단 → 호스팅에서 Rate Limiting 설정

413 Request Entity Too Large — 파일 크기 초과

업로드하는 파일이 서버 허용 용량을 초과할 때 발생합니다.

• 주요 원인: PHP의 upload_max_filesize 및 post_max_size 제한 초과
• 빠른 해결법: php.ini 또는 .htaccess에 아래 코드 추가:

php_value upload_max_filesize 128M
php_value post_max_size 128M

카페24 호스팅에서는 [호스팅 관리] → [PHP 설정]에서 수치를 변경할 수 있습니다.

6. PHP 및 코어 오류 해결법

PHP Fatal Error / Critical Error

PHP 코드 자체의 오류로, 플러그인이나 테마가 현재 PHP 버전과 맞지 않을 때 주로 발생합니다. 워드프레스 화면이 완전히 흰색으로 나타나는 “흰 화면(White Screen of Death,
WSoD)” 증상과 함께 나타나는 경우가 많습니다.

• 주요 원인: PHP 버전 비호환, 플러그인/테마의 코드 오류, 메모리 한도 초과

단계별 해결 방법

1. 디버그 모드 활성화: wp-config.php에 define('WP_DEBUG', true); 추가 후 오류
   메시지 확인
2. 플러그인 전체 비활성화: FTP로 /wp-content/plugins/ 폴더명을
   plugins_disabled로 변경
3. 기본 테마로 전환: FTP로 현재 테마 폴더명을 변경하면 워드프레스가 기본 테마(Twenty Twenty-Four)로 전환됩니다.
4. PHP 버전 확인 및 변경: 카페24 호스팅 관리자에서 PHP 8.1 이상으로 변경합니다.
5. wp-config.php 메모리 증가: define('WP_MEMORY_LIMIT', '512M'); 추가

흰 화면(WSoD) 긴급 해결법

관리자 화면조차 열리지 않는 경우, FTP 또는 카페24 파일 관리자를 통해 직접 접근해야 합니다.

1. 카페24 호스팅 관리자 → [FTP 관리] → [파일 관리자] 접속
2. /wp-content/plugins/ 폴더를 /wp-content/plugins_bk/로 이름 변경
3. 사이트가 정상화되면 플러그인 폴더를 복구하고 하나씩 활성화하며 원인을 파악합니다.

7. 에러 없는 워드프레스 유지하는 법

대부분의 워드프레스 에러는 사전 예방으로 방지할 수 있습니다. 다음 체크리스트를 정기적으로 확인하시기 바랍니다.

필수 예방 체크리스트

카페24 호스팅 권장 설정값

• PHP 메모리 한도: 최소 256MB, 권장 512MB
• 최대 업로드 파일 크기: 최소 64MB (이미지·영상 업로드 많을 경우 128MB 이상)
• PHP 버전: PHP 8.1 이상 (8.2 또는 8.3 권장)
• PHP 실행 시간: 최소 60초, 복잡한 사이트는 120~300초

카페24 호스팅에서는 [나의 서비스 관리] → [호스팅 관리] 메뉴에서 위 설정 대부분을 직접 변경할 수 있습니다. 변경 후에는 사이트가 정상 동작하는지 반드시
확인하시기 바랍니다.

8. 자주 묻는 질문 (FAQ)

Q. 워드프레스 500 에러가 갑자기 발생했어요. 어떻게 해야 하나요?

가장 먼저 플러그인을 전체 비활성화한 후 에러가 해결되는지 확인합니다. 해결되면 플러그인을 하나씩 활성화하며 원인을 찾습니다. 해결되지 않으면 .htaccess 파일을 초기화하거나 PHP 메모리
한도를 늘려보세요. 자세한 내용은 500 에러 해결
가이드를 확인하시기 바랍니다.

Q. 에러 발생 시 가장 먼저 확인해야 할 것은?

1) 워드프레스 디버그 모드를 켜서 정확한 오류 메시지를 확인합니다. 2) 최근 수행한 변경 사항(플러그인 설치, 테마 변경, 업데이트)을 점검합니다. 3) 호스팅 서버 상태를 확인합니다. 이 세
가지 순서로 접근하면 대부분의 에러 원인을 빠르게 찾을 수 있습니다.

Q. 카페24 호스팅에서 PHP 버전을 변경할 수 있나요?

네, 가능합니다. 카페24 호스팅 관리자 페이지에서 [나의 서비스 관리] → [호스팅 관리] → [PHP 버전 선택] 메뉴에서 PHP 버전을 변경할 수 있습니다.
PHP 8.1 또는 8.2를 권장드립니다.

Q. 워드프레스 에러를 미리 예방할 수 있나요?

네, 정기적인 백업 설정, 플러그인·테마·코어 업데이트 관리, 보안 플러그인 설치, PHP 버전 최신 유지를 통해 대부분의 일반적인 에러를 예방할 수 있습니다. 특히 업데이트 전
백업은 반드시 실행하는 습관을 들이시기 바랍니다.

Q. 에러가 해결되지 않으면 어떻게 해야 하나요?

기본 해결 방법으로 해결되지 않는 경우, 카페24 고객센터(1588-3284)에 문의하거나 워드프레스 공식 포럼에서 도움을 받을 수 있습니다. 문의 시 정확한 에러 메시지, 사용 중인 플러그인·테마 목록, PHP
버전 정보를 함께 제공하면 빠른 해결에 도움이 됩니다.

정리 — 워드프레스 에러, 이렇게 대응하세요

워드프레스 에러는 처음에는 당황스럽지만, 에러 코드의 의미를 알고 순서대로 접근하면 대부분 해결할 수 있습니다. 이 가이드의 핵심을 정리하면 다음과 같습니다.

• 5xx 에러: 서버 문제로 플러그인 비활성화, .htaccess 재생성, 호스팅 설정 확인 순서로 점검합니다.
• 4xx 에러: 접근 권한 문제로 파일 권한 설정, 퍼머링크 재생성, 쿠키·캐시 삭제로 대응합니다.
• PHP 오류: PHP 버전 업그레이드와 플러그인 호환성 확인이 핵심입니다.
• 예방: 정기 백업, 업데이트 관리, PHP 버전 유지가 최선의 방어책입니다.

각 에러별 더 자세한 해결 방법은 아래 개별 가이드를 통해 확인하시기 바랍니다.

• 워드프레스 500 Internal Server
  Error 완벽 해결 가이드
• 워드프레스 502 Bad Gateway 완벽 해결 가이드
• 워드프레스 400 에러 해결 가이드