n8nでワークフローを構築中に、突然赤いエラーが出て手が止まった経験はありませんか？エラーメッセージの一部だけを頼りに検索している段階だと、どこから手をつければいいか分からず焦ってしまいますよね。
そこで今回は、n8nでよく遭遇する6種類のエラーを症状別に整理し、原因のタイプを見分けるための「地図」となる記事を作成しました！自分のエラーがどのカテゴリに当てはまるか、この記事内でまず特定してみてください！
この記事で分かること
- n8nのエラーが大きく4タイプに分類できること
- 症状（エラーメッセージ）から該当する原因を素早く特定する方法
- 6つの代表的なエラーの概要と、詳しく解決するための個別記事へのリンク
n8nのエラーは大きく4つのタイプに分かれる
n8nで発生するエラーは、実は無数にあるようで、原因を整理すると4つのタイプに集約されます。まずは自分のエラーがどのタイプに近いか、大まかに把握しましょう。
n8nエラーの4分類
- 通信・API系：外部サービスとの通信に関するエラーです。HTTP Requestノードのレート制限（429）、Google Sheetsなど外部連携のOAuth2認証切れ、Webhookの応答が時間内に返せないタイムアウトなどが該当します。
- リソース系：n8nを動かすサーバーやコンテナのリソース不足が原因のエラーです。大量データ処理時に発生するメモリ不足（out of memory）が代表例です。
- 設定・トリガー系：ワークフローのActive設定やWaitノードの待機時間など、設定不備によって起こるエラーです。Waitノードの待機がWebhook応答期限を超えるケースがこれにあたります。
- コード実行系：CodeノードでJavaScriptを実行する際に、処理内容がV8エンジンのメモリ上限を超えて発生するエラーです。大量ループ処理などで起こりやすいタイプです。
ここで、自分のエラーがどのタイプに当てはまるのか分からないという方も多いと思います。
次のセクションでは、「症状（エラーメッセージの特徴）」を軸にした診断チェックリストをご用意しました。これにより、該当する詳細記事へ迷わず進むことが出来ます。
まさに、「症状からの逆引き診断」というやつですね！
4タイプの関係を整理すると、以下のようになります。
| タイプ | 主な原因 | 代表的なエラー |
|---|---|---|
| 通信・API系 | 外部サービス側の制限・認証切れ | 429、invalid_grant、Webhookタイムアウト |
| リソース系 | サーバー・コンテナのメモリ不足 | out of memory |
| 設定・トリガー系 | ワークフロー設計・タイムアウト設定 | Waitノードタイムアウト |
| コード実行系 | V8エンジンのメモリ超過 | Code node heap out of memory |
「4タイプに分けるって難しそう…」と感じるかもしれませんが、この記事を読めば初心者の方でも大丈夫！次の章から、症状別のチェックリストと、それぞれの対処の要点まで解説します。
症状から探す：n8nエラー診断チェックリスト
まずはエラーメッセージの特徴で照合してください
エラーメッセージの一部だけでも、以下の表と照らし合わせれば該当する記事が見つかります。完全一致でなくても、近い症状の行を確認してみてください。
例：ステータスコード「429」/「Too Many Requests」が表示される
→ HTTP Requestノードのレート制限エラーに該当
| 症状（エラーメッセージの特徴） | 考えられる原因 | 詳細記事 |
|---|---|---|
| HTTP Requestノードで「429」「Too Many Requests」と表示される | 外部APIのレート制限に抵触している | n8n 429エラー（HTTP Requestノードのレート制限エラー） |
| Google Sheetsノードで「invalid_grant」と表示される | OAuth2の認証トークンが失効している | n8n Google Sheets invalid_grant（OAuth2認証切れエラー） |
| Webhook経由の処理が60秒前後で応答なしになる | n8nのデフォルトタイムアウト制限に達している | n8n Webhook タイムアウト（デフォルト60〜64秒制限のエラー） |
| 実行中に突然停止し「out of memory」と表示される | サーバー・コンテナのメモリ容量不足 | n8n out of memory エラー（メモリ不足による実行停止） |
| Waitノードを使った後にWebhook応答が返らない | 待機時間が応答期限の64秒を超過している | n8n Wait ノード タイムアウト（64秒超過でWebhook応答が失敗する問題） |
| Codeノードで「JavaScript heap out of memory」と表示される | V8エンジンのメモリ上限をコード処理が超過している | n8n Code ノード JavaScript heap out of memory（V8エンジンのメモリ超過） |
よくあるn8nエラー6選と対処法の要点
①n8n 429エラー（HTTP Requestノードのレート制限エラー）
HTTP Requestノードで外部APIを短時間に何度も呼び出すと発生します。原因はAPI提供元のレート制限で、n8n自体の不具合ではありません。リトライ間隔の調整やリクエスト分割が対処の要点で、具体的な設定手順は個別記事で解説しています。
▶詳しくはこちら：n8n 429エラー（HTTP Requestノードのレート制限エラー）②n8n Google Sheets invalid_grant（OAuth2認証切れエラー）
Google Sheetsノードを久しぶりに実行した際に起こりやすいエラーです。原因はOAuth2の認証トークンが失効・無効化されたことです。認証情報の再接続が対処の基本ですが、手順は個別記事をご確認ください。
▶詳しくはこちら：n8n Google Sheets invalid_grant（OAuth2認証切れエラー）③n8n Webhook タイムアウト（デフォルト60〜64秒制限のエラー）
外部からのWebhookリクエストへの応答に時間がかかる場合に発生します。原因はn8nのデフォルトタイムアウトが60〜64秒に設定されていることです。処理の非同期化や設定変更が対処の要点で、詳細は個別記事に譲ります。
▶詳しくはこちら：n8n Webhook タイムアウト（デフォルト60〜64秒制限のエラー）④n8n out of memory エラー（メモリ不足による実行停止）
大量データを一括処理するワークフローの実行中に停止します。原因はサーバーやコンテナに割り当てたメモリ容量の不足です。データ分割や設定調整が対処の要点ですが、具体策は個別記事で紹介しています。
▶詳しくはこちら：n8n out of memory エラー（メモリ不足による実行停止）⑤n8n Wait ノード タイムアウト（64秒超過でWebhook応答が失敗する問題）
Waitノードで長時間待機させた後にWebhook応答を返そうとすると起こります。原因は待機時間がWebhookの応答期限である64秒を超えてしまうことです。ワークフロー設計の見直しが必要で、代替方法は個別記事を参照してください。
▶詳しくはこちら：n8n Wait ノード タイムアウト（64秒超過でWebhook応答が失敗する問題）⑥n8n Code ノード JavaScript heap out of memory（V8エンジンのメモリ超過）
Codeノードで大量データをループ処理している際に発生しやすいエラーです。原因はV8エンジンのメモリ上限をCodeノードの処理が超過することです。処理の分割やNODE_OPTIONSの調整が対処の要点で、詳細は個別記事に記載しています。
▶詳しくはこちら：n8n Code ノード JavaScript heap out of memory（V8エンジンのメモリ超過）まとめ：どの記事にも当てはまらない場合の基本チェック手順
今回は、n8nの代表的な6つのエラーを症状別に整理し、原因タイプの診断を行ってみました。
もし上記のどの記事にも当てはまらない場合は、以下の基本チェック手順を先に試してみてください。
- Executionsログの確認
実行履歴からどのノードでエラーが発生したかを特定します。 - Active設定の確認
ワークフローがActive（有効）になっているか、Webhook URLが最新かを確認します。 - 認証情報（Credentials）の再設定確認
各サービスの認証情報が正しく紐付いているか、再接続が必要でないかを確認します。 - n8nおよびノードのバージョン確認
古いバージョンが原因の不具合もあるため、最新版へのアップデートを検討します。 - 環境変数・サーバーリソースの確認
NODE_OPTIONSやEXECUTIONS_DATA_MAX_AGEなど、環境変数の設定やサーバーのCPU・メモリ状況を確認します。
よくある質問
Q1. n8nのエラーログはどこで見れますか？
A. 画面左メニューの「Executions」から実行履歴を開き、失敗した実行をクリックするとエラー内容とどのノードで止まったかを確認できます。
Q2. エラーが出てもワークフロー自体は動いていますか？
A. エラーの種類によります。一部のノードだけ失敗して他は継続する場合もあれば、ワークフロー全体が停止する場合もあります。Executionsログでステータスを確認してください。
Q3. n8n cloud版とセルフホスト版でエラーの対処法は変わりますか？
A. はい、変わります。セルフホスト版は環境変数やサーバーリソースを自分で調整できますが、cloud版はプランのアップグレードなど別の対処が必要になる場合があります。
Q4. どの記事を見ても解決しない場合はどうすればいいですか？
A. n8n公式コミュニティフォーラムで同様のエラー報告がないか検索するか、Executionsログの詳細をもとに新規で質問を投稿することをおすすめします。