AWS の 502 とは何か？（公式の定義）

502 は、HTTP標準仕様（RFC 9110）で定められているステータスコードの一つです。

AWS の文脈では、このコードは次のことを意味します。

ロードバランサーまたはAPI Gateway がバックエンドの EC2 や Lambda から不正な応答を受け取った。

このエラーが発生する主な原因

AWS で 502 が出るときに、最もよく見られる原因を挙げます。

  • バックエンドのアプリケーションが異常終了している
  • Lambda 関数のタイムアウト（処理時間超過）を超えて処理が終わらなかった
  • ALB とターゲットグループのヘルスチェック（正常性確認）が失敗している

具体的な解決手順とチェックリスト

上の原因ごとの対処法を、実行できる手順の形でまとめました。 上から順番に試すことで、多くの場合は解決に近づけます。

  1. EC2インスタンスのアプリケーションログを確認します
  2. Lambda のタイムアウト設定を関数設定画面から延長します
  3. ALB のターゲットグループで「ヘルスステータス」を確認します

それでも解決しない場合は、以下の方法を試してください。

  • AWS の公式ドキュメントで最新の情報を確認する
  • エラーメッセージの全文をコピーして検索エンジンで調べる
  • 公式のコミュニティフォーラムやサポートに問い合わせる

免責事項：本記事の内容は、執筆時点の公開情報をもとに作成したものです。ソフトウェアの仕様は予告なく変更されることがあります。最新の情報は各ツールの公式サポートページをご確認ください。本記事の情報を利用した結果生じたいかなる損害についても、著者および運営者は責任を負いかねます。