로그인 입점하기
← 가이드 목록
시작하기

502 Bad Gateway란? 홈페이지에 갑자기 502 오류가 뜨는 이유 쉽게 이해하기

502는 중간 서버가 실제 홈페이지 서버에서 정상 응답을 받지 못했다는 뜻입니다. 500·504와의 차이, 프록시·CDN·과부하·포트, 운영 점검 포인트까지 초보 기준으로 정리합니다.

502 Bad Gateway란? 홈페이지에 갑자기 502 오류가 뜨는 이유 쉽게 이해하기

홈페이지에 접속했는데 갑자기 502 Bad Gateway가 나올 때가 있습니다. 서버가 완전히 고장난 것처럼 느껴질 수 있지만, 502는 더 구체적인 뜻입니다.

502는 중간에서 요청을 전달하는 서버가, 다른 서버로부터 정상적인 응답을 받지 못했다는 뜻입니다.

쉽게 말하면 — 접수 담당자는 요청을 받았지만, 실제 업무 담당자에게서 제대로 된 답을 받지 못한 상태

사용자 → 중간 서버(Gateway) → 홈페이지 서버 연결이 실패해 502가 나는 흐름
중간 서버까지는 도착했지만, 뒤쪽 서버의 정상 응답이 없을 때

웨이터와 주방 비유

손님은 웨이터에게 주문하고, 웨이터는 주방에 전달합니다. 주방에서 답이 없거나 이상한 답이 오면 웨이터는 음식을 가져올 수 없습니다. 502도 비슷합니다. 사용자 → 중간 서버 → 실제 홈페이지 서버 구조에서, 중간까지는 정상인데 뒤쪽 응답이 깨진 경우입니다.


Gateway란?

Gateway는 중간에서 요청을 넘기는 통로·중계 서버입니다. 요즘 홈페이지는 브라우저가 원본 서버 한 곳에만 직접 붙는 구조만 쓰지 않습니다. 프록시·리버스 프록시, CDN, 로드밸런서, 웹서버, 클라우드 서비스가 사이에 있을 수 있습니다.


502와 500의 차이

둘 다 서버 쪽 오류라 헷갈리기 쉽습니다.

  • 500 — 지금 처리 중인 서버 내부 문제 (주방 안에서 요리 중 사고)
  • 502 — 중간 서버가 뒤쪽 서버의 정상 응답을 못 받음 (웨이터↔주방 전달 실패)

왜 발생할까?

  • 원본 서버 꺼짐 — 중간은 정상인데 홈페이지 서버가 중단
  • 프로그램 정지 — PHP·Node 등 앱이 멈춰 답을 안 줌 (건물은 열렸는데 담당자가 없음)
  • 과부하 — 갑작스러운 접속·무거운 작업으로 응답 실패
  • 프록시 연결 오류 — 이전 후 중간 서버가 옛 주소를 가리킴
  • 포트 불일치 — 3000번으로 가라고 했는데 앱은 8080에서 실행 (잘못된 내선)
  • 방화벽 — 정상 중간 요청까지 차단
  • 재시작 중 — 업데이트·재기동 몇 초 동안만 잠깐 발생

잠깐 나타났다가 사라질 때

새로고침하니 정상인 경우는 일시 과부하·재시작·네트워크 흔들림일 수 있습니다. 한두 번이면 지켜봐도 되지만, 반복되면 서버 환경을 점검하세요.


방문자 vs 운영자

일반 방문자가 고칠 수 있는 부분은 적습니다. 새로고침·잠시 후 재접속·다른 페이지 확인 정도입니다. 계속이면 운영자에게 알려주세요.

운영자는 먼저 실제 홈페이지 프로그램이 실행 중인지 확인합니다. 예: 사용자 → Nginx → 앱 구조에서 Nginx는 정상인데 앱이 꺼져 있으면 502가 납니다. 재시작으로 잠깐 나을 수 있지만, 매일 멈추면 「왜 종료되는가」(메모리·버그·접속량)를 찾아야 합니다.


로그 · 과부하 · CDN · Cloudflare

화면에는 원인이 거의 안 나옵니다. 서버 로그에 연결 실패·시간 초과·잘못된 응답·포트 실패 등이 남을 수 있습니다. 광고·이벤트·바이럴·대량 발송으로 접속이 폭증하면 과부하 → 502로 이어질 수 있습니다.

CDN·Cloudflare도 중간 역할이라, 원본 서버 응답이 깨지면 사용자에게 502가 보일 수 있습니다. 「CDN만 고장」이라고 단정하기보다 원본 상태를 함께 보세요.


DNS · HTTPS · 이전 직후

DNS가 엉뚱한 서버를 가리키면 중간 서버가 정상 답을 못 받을 수 있습니다. HTTPS·SSL 설정이 중간↔원본 사이에서 어긋나도 통신이 실패할 수 있습니다. 서버 이전 직후라면 프로그램 실행 여부, 새 주소·포트·방화벽·SSL·DNS를 한 세트로 확인하세요. 파일만 옮겼다고 이전이 끝난 것은 아닙니다.


502 vs 504 · 범위 확인

  • 502 — 뒤쪽에서 정상적이지 않은 응답
  • 504 Gateway Timeout — 기다렸지만 시간 안에 답이 없음

전체 페이지 502면 앱·서버 연결 전반을, 결제·검색·외부 API만이면 그 기능이 쓰는 별도 서버를 의하세요. 404처럼 「페이지 없음」과는 원인이 다릅니다.


예방 · 검색 · 문의 팁

  • 모니터링 · 앱 자동 재시작 · 예상 접속량에 맞는 자원 · 로그 확인 · 변경 후 실제 접속 테스트
  • 잠깐이면 검색 영향이 작을 수 있지만, 오래 지속되면 검색·사용자 모두 접근이 어렵습니다

업체에는 「오후 2시부터 전체 502 · 오늘 서버 이전」 또는 「메인 정상 · 결제만 502」처럼 시각·범위·최근 작업을 적어 주세요.


자주 묻는 질문

502란?

중간 서버가 원본(또는 다른) 서버에서 정상 응답을 받지 못했다는 뜻입니다.

제 인터넷 문제인가요?

대부분 서버 측입니다. 일시 네트워크도 있으니 새로고침·잠시 후 재시도를 해보세요.

502와 500은 같은가요?

아닙니다. 500은 서버 내부, 502는 중간↔뒤쪽 전달 실패입니다.

재시작하면 해결되나요?

앱이 멈춘 경우엔 도움이 될 수 있습니다. 반복되면 근본 원인을 보세요.

이전 후 502라면?

새 주소·포트·방화벽·프록시·DNS·SSL을 점검하세요.

Cloudflare를 쓰면?

중간 서비스가 원본에서 정상 응답을 못 받으면 502가 보일 수 있습니다. 원본도 확인하세요.


정리

502 = 웨이터는 주문을 받았지만, 주방에서 정상적인 답을 받지 못했다.

앱 정지·과부하·프록시·포트·방화벽 등에서 납니다. 잠깐일 수도 있고, 반복되면 서버를 점검하세요. 비슷하지만 다른 오류는 504 Gateway Timeout, 서버는 있지만 점검·과부하로 일시적으로 서비스를 못 줄 때는 503 Service Unavailable입니다.