ウェブサービスを利用中に「502 Bad Gateway」というエラーページに遭遇したことがある方は多いでしょう。
このエラーはサーバー間の通信に問題が発生していることを示しており、ユーザー側では解決できないケースが多いサーバーエラーのひとつです。
本記事では502エラーの意味・原因・対処法について詳しく解説していきます。
ステータスコード502とは？Bad Gatewayが示す結論
それではまず、ステータスコード502の基本的な定義と意味について解説していきます。
ステータスコード502とは、ゲートウェイまたはプロキシとして機能しているサーバーが、上流のサーバーから不正または無効なレスポンスを受け取った際に返されるHTTPエラーコードです。
「502 Bad Gateway」という名称が示すとおり、ゲートウェイ（中継サーバー）が受け取ったレスポンスが不正であったことを意味します。
5xxエラーはすべてサーバー側の問題を示すカテゴリに属しており、502もクライアント（ユーザー）側の操作に問題があるわけではありません。
主な5xxエラーコードの比較
| コード | 名称 | 原因 |
|---|---|---|
| 500 | Internal Server Error | サーバー内部の予期しないエラー |
| 502 | Bad Gateway | 上流サーバーからの不正レスポンス |
| 503 | Service Unavailable | サーバーが一時的に利用不可 |
| 504 | Gateway Timeout | 上流サーバーからの応答タイムアウト |
502と混同されやすいのが504（Gateway Timeout）ですが、504は上流サーバーが一定時間内にレスポンスを返さなかった場合に発生するのに対し、502は何らかのレスポンスは返ってきたが内容が不正であった場合に発生します。
ゲートウェイとプロキシの役割
502エラーを理解するためには、ゲートウェイとプロキシの概念を把握しておく必要があります。
ゲートウェイとは、異なるネットワーク間でのデータ転送を仲介するサーバーのことです。
プロキシサーバーは、クライアントとサーバーの間に位置し、リクエストを中継する役割を担います。
ロードバランサーやリバースプロキシ（nginxやApache）がゲートウェイとして機能している構成では、上流のアプリケーションサーバーに問題が発生すると502エラーが発生します。
502エラーが発生する典型的な構成
502エラーは特に多層構成のウェブシステムで発生しやすいです。
例えば、nginxリバースプロキシの背後にアプリケーションサーバー（Node.jsやPythonアプリ）が動作している構成において、アプリケーションサーバーがクラッシュしたり応答不能になったりすると、nginxは502を返します。
クラウド環境のロードバランサーとEC2インスタンスの組み合わせでも同様の状況が起こりえるでしょう。
502エラーの主な原因
続いては、502エラーが発生する具体的な原因を確認していきます。
上流サーバーのダウンとクラッシュ
最も一般的な502の原因が、上流サーバーのダウンやアプリケーションのクラッシュです。
アプリケーションサーバーのプロセスが異常終了している場合、ゲートウェイ（プロキシ）はリクエストを転送できず502を返します。
急激なトラフィック増加によるメモリ不足やCPUの過負荷もサーバーダウンの原因となり、結果として502エラーの多発につながります。
ネットワーク接続障害とタイムアウト設定
ゲートウェイと上流サーバー間のネットワーク接続に問題がある場合も502が発生します。
ファイアウォールの設定ミスやネットワーク機器の障害によって通信が遮断されると、ゲートウェイは正常なレスポンスを受け取れません。
また、タイムアウト設定が適切でない場合も問題となります。
設定ミスとサーバーリソースの枯渇
プロキシやロードバランサーの設定ミスも502の原因となります。
上流サーバーのアドレスやポート番号の設定誤り・SSL証明書の問題・プロトコルの不一致なども502を引き起こす可能性があるでしょう。
| 原因カテゴリ | 具体例 | 対処法 |
|---|---|---|
| サーバーダウン | アプリプロセスのクラッシュ | プロセスの再起動・監視強化 |
| ネットワーク障害 | ファイアウォール設定ミス | 設定確認・接続テスト |
| 設定ミス | 上流サーバーアドレスの誤り | 設定ファイルの見直し |
| リソース枯渇 | メモリ・CPU過負荷 | スケールアップ・負荷分散 |
502エラーの対処法と予防策
続いては、502エラーへの具体的な対処法と予防策を確認していきます。
サーバー管理者による対処法
502エラーが発生した際、サーバー管理者はまずエラーログを確認することが最初のステップです。
nginxやApacheのエラーログには、上流サーバーとの通信失敗の詳細が記録されており、原因特定の手がかりが得られます。
上流サーバーのプロセスが停止している場合は再起動を試み、負荷が原因であればスケールアップやスケールアウトを検討します。
ユーザーができる対処法
ユーザー側でできる対処法としては、時間をおいて再アクセスすることが基本です。
502エラーは多くの場合一時的なものであり、サーバー側の問題が解決されると自然に復旧します。
ブラウザのキャッシュをクリアして再試行することも有効な場合があります。
予防策としての監視体制の構築
502エラーを未然に防ぐためには、サーバーの状態を常時監視する体制が重要です。
死活監視ツールを導入し、上流サーバーのプロセスが停止した際に即座にアラートを受け取れるようにすることで、障害の検知と復旧までの時間を大幅に短縮できます。
自動再起動の仕組みを導入することも、可用性向上に効果的でしょう。
まとめ
本記事では、ステータスコード502（Bad Gateway）の意味・原因・対処法について解説しました。
502はゲートウェイが上流サーバーから不正なレスポンスを受け取った際に返されるサーバーエラーであり、ユーザー側の操作ではなくサーバー構成や上流サーバーの状態に問題があります。
ログの確認・プロセスの監視・適切な設定管理を組み合わせることで、502エラーの迅速な検知と復旧、そして予防が可能になります。
サーバー管理者はもちろん、ウェブ開発に携わるすべての方が502の仕組みを理解しておくことが大切です。
