
錯誤含義
502 Bad Gateway:閘道/代理伺服器從上游伺服器收到無效回應。502 為 HTTP 狀態碼,屬 5xx 伺服器端錯誤。
常見成因
- 上游伺服器(應用伺服器、PHP-FPM、Node.js 等)當機、重啟中、或處理超時。
- Nginx/Apache 代理設定錯誤(
proxy_pass 指向錯誤位址/埠)。
- 防火牆/安全群組阻擋代理與上游通訊。
- 上游回應格式不符 HTTP 協定(如缺少 Header、回應過大超過
proxy_buffer_size)。
- 流量暴增導致上游資源耗盡(OOM、CPU 100%)。
HTTP 交互流程中發生點
- 客戶端解析 DNS 取得 IP。
- 建立 TCP 連線至代理/閘道伺服器。
- 發送 HTTP 請求。
- 代理轉發至上游伺服器。
- 上游回應 無效/無回應/錯誤 → 代理向客戶端回傳 502。
排查步驟
- 清除瀏覽器快取,排除舊重導/快取干擾。
- 檢查上游服務狀態:
systemctl status php-fpm、docker ps、應用日誌。
- 查看代理錯誤日誌:Nginx
/var/log/nginx/error.log,搜尋 upstream、502。
- 驗證代理設定:
proxy_pass https://127.0.0.1:9000; 埠號、socket 路徑是否正確。
- 調整緩衝區:
proxy_buffer_size 128k; proxy_buffers 4 256k;。
- 檢查防火牆/雲端安全群組:確保代理能連上游埠口。
- 壓測/監控資源:CPU、記憶體、連線數、磁碟 I/O。
使用者端暫時因應
- 重新整理頁面(暫時性錯誤常自動恢復)。
- 稍後再試,或聯繫網站客服。
- 若所有網站皆 502 → 檢查本地網路/ISP/防火牆;僅特定網站 → 回報該網站管理員。