# AWS 504 Gateway Timeout エラー完全解決ガイド

AWS Elastic Beanstalk で重たい処理を実行した際に、504 Gateway Timeout エラーが発生しました。CloudWatch のメトリクスではHTTPCode_ELB_5XXに記録されます。

本記事では、504 エラーの原因と解決方法を詳しく解説します。

# HTTP 500 系エラーの種類

HTTP 500 系のエラーには、以下のような種類があります。

502-504 エラーが一般的でよく見られます。プログラムスペルミスなどでよく 503 起こります。507 エラーはたまにサーバーの容量不足で起こります。何年かに一回出て、長年会ってない親戚みたいな気持ちになります。

# 504 エラーの原因調査

今回の AWS 504 timeout エラーの原因として、以下の 4 つを調査しました。

# 解決方法 1：Apache サーバー設定の変更

Apache のタイムアウト設定を変更することで、504 エラーを解決できる場合があります。

# 推奨設定値

# 設定ファイルの場所

Linux の場合:

/etc/apache2/apache2.conf

Windows XAMPP の場合:

xampp/apache/conf/original/extra/httpd-default.conf

#
# Timeout: The number of seconds before receives and sends time out.
#
Timeout 300

#
# KeepAlive: Whether or not to allow persistent connections (more than
# one request per connection). Set to "Off" to deactivate.
#
KeepAlive On

#
# MaxKeepAliveRequests: The maximum number of requests to allow
# during a persistent connection. Set to 0 to allow an unlimited amount.
# We recommend you leave this number high, for maximum performance.
#
MaxKeepAliveRequests 10000

#
# KeepAliveTimeout: Number of seconds to wait for the next request from the
# same client on the same connection.
#
KeepAliveTimeout 300

# AWS ELB 用 Apache 推奨設定

AWS ELB（Elastic Load Balancer）を使用している場合の推奨設定は以下の通りです。

# 解決方法 2：ロードバランサーのアイドルタイムアウト設定変更

# CloudWatch メトリクスで確認

CloudWatch メトリクスを確認し、HTTPCode_ELB_5XXメトリクスにデータポイントが存在する場合、時間内に処理が完了しなかったため、ロードバランサーのアイドルタイムアウトで引っかかった可能性があります。

# 解決方法の選択

以下の 2 つの方法があります。

1. アイドルタイムアウト値を変更（コストなし）
2. インスタンスの計算能力を上げる（コストあり）

# ロードバランサーのタイムアウト設定変更手順

1. Amazon EC2 (opens new window)コンソールを開く
2. サイドメニュー[LOAD BALANCING] -> [ロードバランサー]を選択
3. 対象のロードバランサーを選択
4. [Description]タブ -> [Edit idle timeout]を選択
5. [Configure Connection Settings] -> [Idle timeout]の値を1 - 4000 秒に変更
6. [Save]を選択

# 実装時の注意点

AWS 504 Gateway Timeout エラーの解決方法。

1. Apache サーバー設定の変更

   • Timeout、KeepAliveTimeout を適切な値に設定
   • ELB 使用時は、アイドルタイムアウトより大きい値に設定

2. ロードバランサーのアイドルタイムアウト設定変更

   • CloudWatch で HTTPCode_ELB_5XX を確認
   • 必要に応じてアイドルタイムアウト値を延長（最大 4000 秒）

3. インスタンスのスケールアップ（最終手段）

   • 処理時間を短縮するため、インスタンスタイプを変更

関連情報: AWS ELB アイドルタイムアウト設定 (opens new window)