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

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

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

最後更新：2026/7/21

確認版本與資料處理基礎

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

1. 掌握版本差異與升級範圍
n8n 2.38.5 升級怎麼做？先處理安全修補，再隔離測 2.39.1
n8n 2.38.5 目前是 latest、stable 與 rc，2.39.1 位於 beta／next。本文更新 2.37.7／2.38.2 安全基線、2.38.5／2.39.1 頻道分流、Docker 固定版本、備份、migration、OAuth、Webhook、AI、MCP 與 Queue Mode 回歸。
2. 看懂 Item 結構與過濾方式
n8n 踩坑筆記：為什麼 Code 節點的資料過濾沒有生效？
深入解析 n8n Code 節點中 $input.all() 的資料包裝機制，並提供兩種正確的資料過濾解決方案

選擇合併節點與資料形狀

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

3. 選擇 Merge 或 Aggregate
n8n 踩坑筆記:Code 節點無法合併資料?該用 Merge 節點還是 Aggregate?
記錄在 n8n 中嘗試用 Code 節點合併多個資料源失敗的經驗,以及 Aggregate 節點資料解包的正確方法

排查 Loop 與 Merge 資料流

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

4. 修正 Loop 搭配 Merge 的陷阱
n8n 踩坑筆記：Merge 節點搭配 Loop 的常見陷阱與解法
在 n8n 中使用 Merge 節點搭配 Loop 時，資料分批輸出、Join 失敗等問題的完整解決方案

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

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

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