TrueURL
TrueURL

메뉴

502 잘못된 게이트웨이

게이트웨이나 프록시가 업스트림 서버로부터 유효하지 않은 응답을 받았습니다. nginx 뒤의 애플리케이션이 다운된 경우가 그 예입니다.

사유 구절
Bad Gateway
리디렉션 여부
아니요
기본 캐시 가능 여부
아니요

502 Bad Gateway는 게이트웨이나 프록시 역할을 하는 서버가 요청을 처리하기 위해 접속한 업스트림 서버로부터 유효하지 않은 응답을 받았다는 뜻입니다. 프록시 자체는 정상이며, 문제는 그 뒤에 있습니다.

일반적인 구성에서 프록시는 nginx, Apache, 로드 밸런서, CDN이고, 업스트림은 PHP-FPM, Node.js, Gunicorn, 컨테이너 같은 애플리케이션 서버입니다. “유효하지 않은 응답”에는 연결 거부나 연결 재설정, 응답 도중의 비정상 종료, 형식이 잘못된 헤더, 프록시 버퍼보다 큰 헤더(nginx는 “upstream sent too big header”를 기록함) 등이 포함됩니다.

Cloudflare에서는 원본 서버 문제가 대개 520, 521, 522 같은 더 구체적인 코드로 나타납니다. Cloudflare를 통해 보이는 일반 502는 원본 서버 자체에서 왔을 수도 있고, Cloudflare 네트워크 내부의 문제에서 비롯되었을 수도 있습니다.

응답 예시

HTTP
HTTP/1.1 502 Bad Gateway
Date: Fri, 06 Nov 2026 10:15:32 GMT
Server: nginx
Content-Type: text/html
Content-Length: 142
Connection: keep-alive

<html>
<head><title>502 Bad Gateway</title></head>
<body>
<center><h1>502 Bad Gateway</h1></center>
<hr><center>nginx</center>
</body>
</html>

SEO 및 리디렉션 검사

다른 5xx 오류와 마찬가지로 502가 잠시 발생하면 크롤링이 느려지지만 페이지가 삭제되지는 않으며, 502가 계속되면 색인에서 제외됩니다. 502는 워커 재시작이나 풀 포화처럼 간헐적으로 발생하는 경우가 많으므로, URL을 여러 번 검사하거나 리디렉션 일괄 검사 도구로 얼마나 자주 실패하는지 확인하세요.

주요 원인과 사용 사례

  • 애플리케이션 서버(PHP-FPM, Node.js, Gunicorn)가 다운되었거나, 재시작 중이거나, 비정상 종료되었습니다.
  • 프록시가 잘못된 업스트림 주소, 포트, 소켓을 가리킵니다.
  • 업스트림의 응답 헤더가 프록시 버퍼를 초과합니다(nginx의 proxy_buffer_size나 fastcgi_buffer_size).
  • 방화벽이나 보안 그룹이 프록시에서 백엔드로의 접속을 차단합니다.

URL 리디렉션 검사

무료 TrueURL 리디렉션 검사 도구로 URL이 반환하는 모든 상태 코드를 홉별로 확인하세요.