HTTP 500、502、503のトラブルシューティング方法

5xxエラーはサーバー側の障害を意味しますが、各コードは異なる障害レイヤーを示します。このガイドでレイヤーを素早く切り分けられます。

迅速なトリアージ（最初の5分）

1. URLを ウェブサイトチェッカー で実行し、ステータスと応答時間を記録します。
2. 問題が1つのURLパスだけか、すべてのエンドポイントに影響するか確認します。
3. エラーが安定しているか断続的かを確認します。
4. デプロイ、設定変更、トラフィック急増と関連付けます。

500 Internal Server Error

一般的なアプリ/サーバー障害です。よくある原因：未捕捉のアプリケーション例外、環境変数の誤り、権限の問題、依存関係呼び出しの失敗。

• まずアプリケーションログ、次にウェブサーバーログを確認します。
• 最近のリリースとマイグレーションを確認します。
• ファイル権限とランタイムのシークレットを検証します。

502 Bad Gateway

通常、Nginx/Apache/ロードバランサーと上流アプリの間のプロキシ/ゲートウェイの問題です。

• 上流プロセスが稼働し、想定のホスト/ポートで待ち受けているか確認します。
• プロキシのタイムアウトとkeepaliveの不一致を確認します。
• コンテナ環境では上流DNSを検証します。

503 Service Unavailable

サービスが一時的に利用できません。過負荷、メンテナンスモード、ワーカープールの枯渇がよくある原因です。

• CPU、メモリ、コネクションプールの飽和を調べます。
• オートスケーリングとレート制限を確認します。
• メンテナンスフラグや誤設定のヘルスチェックを検証します。

サポートエスカレーションで送る内容

• URL + 正確なステータスコード
• 初回確認時刻（UTC推奨）
• 問題がグローバルか地域限定か
• 最近のデプロイやインフラ変更の有無

DNS側の障害については、 DNS伝播ガイドを参照してください。証明書のホスト名不一致については、 このSSLガイドを参照してください。