How to set a timeout on a http.request() in Node? の解決方法【2025年最新版】

エラーの概要・症状

Node.jsを使用してHTTPリクエストを行う際に、リクエストがタイムアウトする問題に直面することがあります。このエラーは、特にネットワークの不安定さやサーバーの遅延によって引き起こされることが多く、ユーザーがリクエストを送信した後、応答が得られない状態が続くことを意味します。

例えば、リクエストを実行してから数秒が経過してもサーバーからの応答がない場合、プログラムは無限に待機することになります。これにより、アプリケーションがフリーズしたり、ユーザー体験が悪化したりする可能性があります。特に、APIを利用するアプリケーションでは、他の処理が完了するまで待たされることにより、全体のパフォーマンスが低下します。

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

HTTPリクエストのタイムアウトが発生する原因は主に以下の通りです。

1. ネットワークの遅延: ネットワーク接続が不安定である場合、リクエストが送信されてから応答が返ってくるまでに時間がかかることがあります。

2. サーバーの負荷: リクエストを処理するサーバーが高負荷状態にある場合、応答が遅れることがあります。特に多数のリクエストが同時に送られる場合、サーバーが処理しきれずにタイムアウトが発生することがあります。

3. タイムアウト設定の欠如: Node.jsのHTTPリクエストにはデフォルトでタイムアウトが設定されていないため、プログラマが明示的にタイムアウトを設定しない限り、リクエストは無限に待機します。

4. 不正なURL: 不正なURLや存在しないサーバーへのリクエストも、タイムアウトの原因となることがあります。送信先のサーバーが応答できない場合、リクエストはタイムアウトします。

5. クライアント側の設定ミス: HTTPリクエストの設定ミスもタイムアウトの一因です。リクエストオプションが不適切に設定されていると、期待する動作が得られません。

解決方法1（最も効果的）

Node.jsでHTTPリクエストのタイムアウトを設定する最も効果的な方法は、http.requestメソッドのオプションにtimeoutを指定することです。以下にその手順を示します。