n8nで複数ファイル取得ができない原因｜Merge・gzip・Codeノードで詰まった全記録

原因

MergeノードをMode: Combine / Combine By: Positionで設定すると、4つのアイテムが「横結合」されて1アイテムに圧縮されます。このとき、同じフィールド名（data）が上書きされて最後の1件しか残りません。

Input 1: { data: "create-article.txtの中身" }
Input 2: { data: "internal_links.csvの中身" }
Input 3: { data: "title_rules.mdの中身" }
Input 4: { data: "_index.jsonの中身" }
↓ Combine / Position
Output: { data: "_index.jsonの中身" }  ← 最後の1件だけ残る

解決策：AppendモードとInclude Any Unpaired Itemsを使う

MergeノードのModeをAppendに変更し、Options → Include Any Unpaired Itemsをオンにします。

これにより、4つのアイテムが縦に並んで出力されます。

Output[0]: { data: "create-article.txtの中身" }
Output[1]: { data: "internal_links.csvの中身" }
Output[2]: { data: "title_rules.mdの中身" }
Output[3]: { data: "_index.jsonの中身" }

詰まり③｜Codeノードが4回実行される（実行モード問題）

「Mergeノードを通った後のCodeノードで、4つのアイテムが全部取れない。毎回1アイテムしか来ていない」——これが3番目の詰まりです。

症状

$input.all()で全アイテムを取得しようとしているのに、デバッグするとアイテム数が常に1になっています。実行回数を見ると4回実行されていました。

原因

CodeノードのデフォルトはSettings → Run Once for Each Itemになっています。Mergeから4アイテムが来ると、アイテムごとに1回ずつCodeノードが実行されるため、毎回$input.all()で取得できるのは1アイテムだけになります。

解決策：Run Once for All Itemsに変更する

CodeノードのSettingsタブを開いて、Run Once for All Itemsに変更します。

これにより、4アイテムがまとめてCodeノードに渡され、$input.all()で全4アイテムが取得できるようになります。

const allItems = $input.all();
console.log('アイテム数:', allItems.length); // → 4

解決フロー｜Extract → Merge → Code（再現手順）

3つの問題を切り分けて解決すると、以下のフローが完成します。

[並列4ブランチ]
├ Download file → Extract from File
├ Download file → Extract from File
├ Download file → Extract from File
└ Download file → Extract from File
        ↓
Merge（Mode: Append / Include Any Unpaired Items: ON）
        ↓
Code（Settings: Run Once for All Items）

Step1：各ブランチにExtract from Fileを追加する

全4本のDownload fileノードの直後に、それぞれExtract from Fileノードを追加します。設定は全て同じです。

• Operation：Extract From Text File
• Input Binary Field：data
• Destination Output Field：data

Step2：MergeノードをAppendモードに設定する

Mergeノードの設定を変更します。

• Mode：Append
• Number of Inputs：4
• Options → Include Any Unpaired Items：ON

Step3：CodeノードをRun Once for All Itemsに変更する

CodeノードのSettingsタブで「Run Once for All Items」を選択します。

Step4：Codeノードで順番指定してデータを取得する

MergeのAppendモードでは、Mergeノードへの接続順がそのままallItemsの配列順に反映されます。これはn8nがMergeの入力を「Input 1」「Input 2」という番号で管理しており、その番号順にアイテムを並べるためです。

どのブランチがどの順番になっているかは、Mergeノードを開いてINPUT側のドロップダウンで確認できます（「Input 1：Get create-article」のように表示されます）。

const allItems = $input.all();

// 接続順でファイルを取得（Input 1〜4の順番に対応）
const createArticleText = allItems[0]?.json.data ?? null;
const internalLinksText = allItems[1]?.json.data ?? null;
const titleRulesText    = allItems[2]?.json.data ?? null;
const indexText         = allItems[3]?.json.data ?? null;

// _index.jsonはJSONとしてパース
const indexData = indexText ? JSON.parse(indexText) : null;

// 上流ノードからキーワード情報を引き継ぐ
const manifest = $('Code in JavaScript').first().json;

return [{
  json: {
    keyword:              manifest.keyword,
    intent:               manifest.intent,
    slug:                 manifest.slug,
    index_data:           indexData,
    internal_links_data:  internalLinksText,
    create_article_data:  createArticleText,
    title_rules_data:     titleRulesText
  }
}];

接続順を変更するときのリスク： ワークフローを編集してMergeへの接続順を変えると、allItems[0]〜allItems[3]が取得するファイルが入れ替わります。接続順を変えた場合は必ずCodeノードのインデックスも合わせて修正してください。確認方法はMergeノードのINPUTドロップダウンを見ることです。

判断基準：

• データが取れない → まず単体のブランチをExtract from FileのOUTPUTで確認する
• Mergeで1アイテムしか出ない → ModeをAppendに変更してInclude Any Unpaired ItemsをONにする
• Codeが複数回実行される → Run Once for All Itemsに変更する

判断基準｜「動かない」は必ず構造の問題

今回の経験で最も重要だと感じたのは、「3つの問題が独立している」という点です。

gzip問題を解決してもMergeで壊れ、Mergeを修正してもCodeが複数回実行される——それぞれ原因が違うので、1箇所直しても次の問題が出てきます。同じ詰まりを繰り返す人の多くは、「1つ直したのになぜまだ動かないのか」で止まります。構造を分解できていないと、どこに問題があるかが見えないのです。

このとき有効なのが「1ブランチ単体でテストする」という切り分け方法です。

切り分けの手順：

• 4ブランチのうち1本だけをExtract from FileのOUTPUTでテストする
• 中身が正しく取れることを確認する
• 次にMergeをテストして全アイテムが縦に並んでいることを確認する
• 最後にCodeノードでアイテム数が4になっていることを確認する

この順番で1ステップずつ確認すると、どこで問題が起きているかが特定できます。

この後どうなったか・よくある質問

この解決フローを定着させたことで、4ファイルの並列取得→統合→LLM送信というパイプラインが安定して動くようになりました。現在は同じパターンを使って記事自動生成ワークフロー全体を構築しています。

Q. Extract from FileのOperationは他にも種類がありますか？

あります。CSV・Excel・HTMLなど複数の形式に対応しています。今回はtxt・md・json形式のテキストファイルを扱うため「Extract From Text File」を使いました。バイナリとして扱いたい場合や画像ファイルの場合は別のOperationを選択します。

Q. Mergeノードに接続する順番は重要ですか？

重要です。AppendモードではInput 1・Input 2の接続順にアイテムが並びます。CodeノードでallItems[0]のように順番指定で取得するため、接続順を変えると取得するファイルが入れ替わります。MergeノードのINPUTドロップダウンで接続順を必ず確認してください。

まとめ

n8nで複数ファイルを取得・統合するときの解決フローをまとめます。

• gzip問題 → Download fileの後にExtract from File（Extract From Text File）を挟む
• Merge問題 → ModeをAppendに変更してInclude Any Unpaired ItemsをONにする
• 実行モード問題 → CodeノードをRun Once for All Itemsに変更する
• データ取得 → allItems[0]〜[3]で接続順に指定して取得する

今日から試せる一歩として、まず1本のブランチだけをExtract from FileのOUTPUTで確認してみてください。中身が正しくテキストとして取れているかを確認するだけで、次に何をすべきかが見えてきます。