홈 › HTTP 상태 코드
502 Bad Gateway 오류 뜻과 해결 방법
하이퍼텍스트 전송 프로토콜(HTTP) 502 Bad Gateway 에러 응답코드는 서버가 게이트웨이나 프록시 서버 역할을 하면서 업스트림 서버로부터 유효하지 않은 응답을 받았다는 것을 의미합니다.
이 코드는 게이트웨이나 프록시 역할을 하는 서버가 업스트림 서버로부터 유효하지 않은 응답을 받았다는 뜻의 서버 오류(5xx) 응답입니다. 500처럼 포괄적인 서버 오류이지만 요청 경로 중 어느 지점에서 문제가 났는지가 특정된다는 점이 다릅니다.
어디서 나오나: 웹사이트 접속·API 호출 응답으로
해결 순서
다른 방문자에게는 서비스가 정상인데 자신만 502를 본다면, 특히 VPN이나 별도 네트워크 구성을 쓰고 있다면 네트워크 설정, 방화벽 설정, 프록시 설정, DNS 구성을 확인하세요. [원문]
운영자라면 원본 서버가 유효한 HTTP 오류 응답을 보낸 경우 502로 바꾸지 말고 그 응답을 그대로 클라이언트에 전달해 실패 이유가 드러나게 하세요. [원문]
운영자라면 프록시나 게이트웨이가 원본 서버로부터 아무 HTTP 응답도 받지 못한 경우에는 502가 아니라 504 Gateway Timeout을 보내세요. [원문]
공통 절차: HTTP 상태 코드 한눈에
그래도 안 될 때
그 밖의 502 원인은 다양하며, 해결에는 서버 운영자나 관리자의 조사가 필요합니다.
같은 오류의 다른 표기
Bad Gateway HTTP 502 하이퍼텍스트 전송 프로토콜(HTTP) 502 Bad Gateway 에러 응답코드는 서버가 게이트웨이나 프록시 서버 역할을 하면서 업스트림 서버로부터 유효하지 않은 응답을 받았다는 것을 의미합니다.