502 (Bad Gateway) response
오류 메시지·상태명
빠른 답변
- 이 오류는 무엇인가요?
- Apache httpd mod_proxy가 구문적으로 잘못된 원본 서버 응답 헤더를 처리할 때 반환하는 502 응답을 식별합니다.
- 가장 흔한 원인은 무엇인가요?
- 원본 서버의 응답 헤더에 콜론이 없는 행이 있고 `ProxyBadHeader`가 기본값 `IsError`이면 mod_proxy는 요청을 중단하고 `502 (Bad Gateway) response`가 됩니다.
- 무엇을 먼저 확인해야 하나요?
- 현재 프록시 경유 요청의 응답 상태가 `502 (Bad Gateway) response`인지 확인합니다.
현재 증상
- 서버 5xx 응답
먼저 확인할 항목
현재 프록시 경유 요청의 응답 상태가 `502 (Bad Gateway) response`인지 확인합니다.
응답 상태가 `502 (Bad Gateway) response`이면, 원본 서버의 콜론 없는 응답 헤더 행과 `ProxyBadHeader IsError` 조건에서의 mod_proxy 동작과 일치하는지 확인합니다.
환경별 원인과 조치
증상
Apache httpd mod_proxy 경유 요청의 응답 상태가 502 (Bad Gateway) response입니다.
확인
- 현재 프록시 경유 요청의 응답 상태가
502 (Bad Gateway) response인지 확인합니다. - 이 응답 상태가 확인되면, 원본 서버가 콜론이 없는 구문적으로 잘못된 응답 헤더 행을 보냈고
ProxyBadHeader가IsError일 때의 mod_proxy 동작과 일치합니다.
이 대조만으로는 원본 서버 응답 헤더나 현재 ProxyBadHeader 설정값을 확인할 수 없습니다.
관련 동작
IsError는 요청을 중단하고502 (Bad Gateway) response가 됩니다. 기본값입니다.Ignore는 잘못된 헤더 행을 전송되지 않은 것처럼 처리합니다.StartBody는 첫 번째 잘못된 헤더 행을 받은 뒤 헤더 읽기를 끝내고 나머지를 본문으로 처리합니다.
StartBody는 헤더와 본문 사이의 빈 행을 넣지 않는 백엔드 서버를 처리하는 데 도움이 될 수 있습니다.
참고 자료
Apache HTTP Server · 공식 자료 (새 창에서 열림)
확인 범위: `ProxyBadHeader`는 원본 서버에서 콜론이 없는 구문적으로 잘못된 응답 헤더 행을 받을 때 mod_proxy의 동작을 결정합니다., `ProxyBadHeader IsError`는 기본값이며 요청을 중단하고 `502 (Bad Gateway) response`가 됩니다., `Ignore`는 잘못된 헤더 행을 전송되지 않은 것처럼 처리하고, `StartBody`는 첫 번째 잘못된 헤더 행부터 나머지를 본문으로 처리합니다. · 확인일: 2026-07-24