エラーコード: HTTP 502 Bad Gateway 原因と解決策

HTTP 502 Bad Gateway とは

間に立っているゲートウェイやプロキシサーバー（Nginxやロードバランサー）が、背後にいるアプリケーションサーバー（PHP-FPM、Node.js、Tomcatなど）から不正な応答を受け取った、あるいは応答が全く無かった場合に発生するエラーです。

よくある発生原因

1. バックエンドのプロセスが落ちている PHP-FPMやGunicornなどのプロセスがダウンしていると、Nginxは「通信相手がいない」と判断して502を返します。
2. タイムアウト（処理が重すぎる） データベースの重い処理や、無限ループに入ってしまい、プロキシ側が設定した制限時間（例：60秒）以内にバックエンドから応答が返ってこなかった場合に発生します。（※この場合は504 Gateway Timeoutになることもあります）
3. ソケットファイルの権限エラー NginxとアプリケーションサーバーをUnixドメインソケット（.sock形式）で繋いでいる場合、Nginxの実行ユーザーからソケットファイルが読み書きできない権限設定になっていると接続を拒否されて502になります。

解決のための初動対応

• ターミナルで systemctl status php-fpm や docker ps を実行し、バックエンドが起動しているか確認する。
• Nginx等の エラーログ (/var/log/nginx/error.log) を真っ先に確認する。connect() failed (111: Connection refused) のような具体的なエラーが必ず残っています。