意義
閘道或代理從它轉送請求的上游伺服器收到了無效的回應。
常見原因
- 應用程式伺服器當掉或未在監聽(連接埠或 socket 錯誤)
- 上游關閉了連線或送出格式錯誤的標頭
- PHP-FPM、Gunicorn 或 Node 程序重新啟動
解決方法
用戶端或訪客
稍等一下再重試;通常是暫時的。若持續發生,表示網站後端已停擺。
網站或 API 的維護者
確認上游程序正在執行並監聽代理所用的位址,並查看代理的錯誤紀錄以了解確切的上游錯誤。
回應範例
HTTP/1.1
HTTP/1.1 502 Bad Gateway
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: text/html
Content-Length: 0 規範
常見問題
› 如何解決 nginx 的 502 Bad Gateway?
檢查上游(應用程式是否在執行、proxy_pass 位址/socket 是否正確)與 nginx 錯誤紀錄;若應用程式伺服器當掉就重新啟動。
› 502 與 504 的差別?
502:上游回傳無效內容或關閉了連線。504:上游未及時回應。