意味
ゲートウェイまたはプロキシが、リクエストを転送した上流サーバーから無効なレスポンスを受け取りました。
よくある原因
- アプリサーバーがクラッシュした、または待ち受けていない(ポートやソケットの誤り)
- 上流が接続を閉じたか不正なヘッダーを送った
- 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 のアドレスやソケットが正しいか)と nginx のエラーログを確認し、アプリサーバーがクラッシュしていれば再起動します。
› 502 と 504 の違いは?
502:上流が壊れた応答を返したか接続を閉じた。504:上流が時間内に応答しなかった。