HTTP Code: 502 (Bad Gateway)
HTTPステータスコード参照ガイド
ステータスの分類
5xx — サーバーエラー
意味と定義
ゲートウェイまたはプロキシサーバーとして動作しているサーバーが、リクエストを処理するためにアクセスした上位(アップストリーム)サーバーから無効なレスポンスを受信したことを示します。
主な原因
- 上位のバックエンドプロセス(PHP-FPMやNode.jsアプリなど)が停止している
- プロキシサーバーの上位ポート番号の設定ミス
- プロキシの内部ルーティングエラー
HTTPステータスエラーを解決する方法
1. ログの確認: サーバーエラーログ(error.logなど)を確認し、実行中の例外やデータベース切断の原因を特定します。
2. エンドポイントのテスト: Uptimeチェッカーやリダイレクト追跡ツールを使用して、返されるレスポンスヘッダーを確認します。
3. ルールの定義: 下記の設定例を参考に、NginxやApacheでカスタムエラーページやリダイレクトルールを構成します。
Nginx 設定方法
location / {
proxy_pass http://127.0.0.1:3000;
proxy_next_upstream error timeout invalid_header http_502;
}Apache 設定方法
ProxyPass / http://127.0.0.1:3000/ ProxyPassReverse / http://127.0.0.1:3000/