適合:n8n 初學者、工作流程自動化開發者、需要排查資料流的使用者

n8n 資料處理與 Code Node 排錯指南

從 n8n 版本與 Item 資料結構開始,依序處理 Code Node 過濾、Merge/Aggregate 選擇、Loop 資料流陷阱,最後再接上 Perplexity MCP 搜尋能力。

最後更新:

確認版本與資料處理基礎

先確認目前版本變化,再理解 n8n Item 的 json 包裝,避免用一般 JavaScript 陣列的直覺誤判資料。

  1. 1. 掌握版本差異與升級範圍

    n8n 2.23 升級到 2.30.4:實用新功能與版本建議

    n8n 從 2.23 到 2.30.4 更新了什麼?本文整理 Webhook 過濾、AI Agent PDF、GitHub PR、Slack 排程、Microsoft 應用程式驗證等實用功能,並說明為何正式環境目前建議升到 2.29.10。

  2. 2. 看懂 Item 結構與過濾方式

    n8n 踩坑筆記:為什麼 Code 節點的資料過濾沒有生效?

    深入解析 n8n Code 節點中 $input.all() 的資料包裝機制,並提供兩種正確的資料過濾解決方案

選擇合併節點與資料形狀

分清 Code、Merge 與 Aggregate 各自負責的資料形狀,避免把多筆輸入錯誤地壓進單一 item。

  1. 3. 選擇 Merge 或 Aggregate

    n8n 踩坑筆記:Code 節點無法合併資料?該用 Merge 節點還是 Aggregate?

    記錄在 n8n 中嘗試用 Code 節點合併多個資料源失敗的經驗,以及 Aggregate 節點資料解包的正確方法

排查 Loop 與 Merge 資料流

當迴圈輸出缺筆、重複或順序不符預期時,沿著每次 iteration 與 Merge 模式檢查資料。

  1. 4. 修正 Loop 搭配 Merge 的陷阱

    n8n 踩坑筆記:Merge 節點搭配 Loop 的常見陷阱與解法

    在 n8n 中使用 Merge 節點搭配 Loop 時,資料分批輸出、Join 失敗等問題的完整解決方案

完成核心資料流後再擴充外部能力

核心資料結構穩定後,再把即時搜尋透過 MCP 接進工作流,降低同時排查資料與外部服務的複雜度。

  1. 5. 延伸串接 Perplexity MCP 搜尋

    如何在 n8n 中使用 Perplexity-Ask MCP 進行即時網路搜尋

    本文介紹如何在 n8n 自動化平台中整合 Perplexity-Ask MCP,實現 AI 即時網路搜尋,並提供安裝設定步驟、常見問題與參考連結。