はじめに

Web サイトやアプリケーションを運用していると、エラーに遭遇することは避けられません。

その中でも「504 Gateway Time-out」というエラーは、サーバーの応答遅延が原因で発生することが多く、特にリバースプロキシやロードバランサーを利用している環境では頻発することがあります。

本記事では、このエラーの原因と対処法について詳しく解説します。

記事を書こうと思ったきっかけ

受講しているハッカソンの活動中に、他の受講生が 504 Gateway Time-out エラーに直面していました。

原因の特定や解決に苦労している様子を見て、一緒に調査を進める中で多くの知見を得ることができました。

同じ問題に悩む方の助けになればと思い、この記事を書くことにしました。

Web サイトやアプリケーションを運用していると、「504 Gateway Time-out」というエラーに遭遇することがあります。

このエラーは、ゲートウェイ（リバースプロキシやロードバランサー）が、バックエンドサーバーからの応答を受け取れず、一定時間が経過したために発生します。

本記事では、504 Gateway Time-out エラーの主な原因と具体的な対策について解説します。

NGINX の場合 (/etc/nginx/nginx.conf)

http {
    proxy_connect_timeout 600;
    proxy_send_timeout 600;
    proxy_read_timeout 600;
    send_timeout 600;
}

Apache の場合 (/etc/httpd/conf/httpd.conf または /etc/apache2/apache2.conf)

Timeout 600

「504 Gateway Time-out」エラーは、サーバーの負荷、設定ミス、アプリケーションの処理速度、データベースの遅延、クラウド環境の設定、ネットワークの問題など、さまざまな要因で発生します。

まずは サーバーの負荷を確認し、設定の見直しや処理の最適化を進める ことが重要です。

特に NGINX/Apache のタイムアウト設定やデータベースのチューニング など、適切な対策を施すことで、このエラーを回避できます。