글 목차
워드프레스 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을 임시로 중지하고 오류가 해결되는지 확인합니다.
- 카페24 호스팅 제어판(hosting.cafe24.com) 로그인
- 나의서비스관리 → 호스팅관리 → 연장/변경/추가옵션 클릭
- 무료 CDN 신청 항목에서 CDN 서비스 상태 확인
- CDN이 활성화 상태라면 임시로 해제 또는 중지 처리
- 30분 후 사이트 접속 재확인
오류가 해결된다면 CDN 설정이 원인입니다. CDN을 다시 활성화한 뒤 워드프레스 관리자 화면 → 설정 → 캐시 플러그인 설정에서 CDN URL이 올바르게 입력되어 있는지 확인합니다.
3단계: DNS 설정 점검
최근 도메인을 이전하거나 DNS 레코드를 변경한 경우 설정을 점검합니다.
- 카페24 호스팅 제어판 로그인
- 나의서비스관리 → 도메인 관리 → DNS 관리 클릭
- A 레코드: 도메인이 올바른 서버 IP를 가리키고 있는지 확인
- CNAME: www 도메인이 루트 도메인을 올바르게 가리키는지 확인
- 네임서버: 카페24 네임서버(ns1.cafe24.com, ns2.cafe24.com)로 설정되어 있는지 확인
DNS 변경 직후라면 전파가 완료될 때까지 최대 48시간이 소요됩니다. 전파 상태는 DNSChecker.org에서 확인하실 수 있습니다.
4단계: 캐시 및 프록시 플러그인 비활성화
캐시 플러그인이 충돌하는 경우 FTP로 접속하여 해당 플러그인을 비활성화합니다.
- FTP 클라이언트(FileZilla 등) 또는 카페24 파일 관리자로 접속
- wp-content/plugins 폴더로 이동
- 캐시 관련 플러그인 폴더명 변경
wp-rocket→wp-rocket_disabledw3-total-cache→w3-total-cache_disabled
- 사이트 접속 확인
- 해결된 경우 캐시 플러그인 설정을 새로 구성하거나 대체 플러그인으로 교체
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 환경에서의 해결 방법을 함께 살펴보겠습니다.
