本文是「n8n 完全指南」系列的一部分。
流程壞了不要慌，先看錯誤訊息
n8n 最讓初學者頭痛的，往往不是「不知道怎麼建流程」，而是「流程突然壞了，不知道從哪裡開始排查」。
好消息是：n8n 的錯誤訊息其實相當詳細，90% 的問題都能從錯誤訊息中找到方向。壞消息是：如果你不知道這些訊息代表什麼意思，看了也沒用。
這篇文章整理了最常見的 8 類錯誤，說明原因，並給出具體的排解步驟。
錯誤一：Webhook 節點收不到資料
症狀： Webhook URL 正確貼上了，但觸發後 n8n 流程沒有收到資料，節點一直在等待。
常見原因：
- Webhook 模式設錯了。n8n 的 Webhook 節點有「Test URL」和「Production URL」兩種，測試時用 Test URL，正式上線後要換成 Production URL，很多人在切換時忘記更新外部服務的設定。
- 流程沒有啟用（Active）。在正式環境中，流程必須是 Active 狀態，Webhook 才會持續監聽。測試模式的 Webhook 只在你點「Execute Workflow」後才短暫監聽。
- 防火牆或網路阻擋。自架版的 n8n 如果伺服器的防火牆沒有開放 Port 5678，外部無法連入。
排解步驟：
- 確認流程已設為 Active
- 確認使用的是 Production URL（不是 Test URL）
- 自架版：確認伺服器防火牆開放對應 Port，並確認 n8n 的 WEBHOOK_URL 環境變數設定正確
錯誤二：Authentication Error（認證失敗）
症狀： 節點顯示「Authentication Error」或「401 Unauthorized」，通常出現在 Google Sheets、Gmail、Slack 等需要 OAuth 的節點。
常見原因：
- OAuth Token 過期。Google 等服務的 Token 有時效，過期後需要重新授權。
- 憑證（Credentials）設定有誤，如 API Key 貼錯、多了空格。
- 服務的 API 權限範圍不足，Token 有了但沒有開啟需要的權限。
排解步驟：
- 進入 Credentials 頁面，點選對應的憑證，嘗試「Reconnect」重新授權
- 確認 API Key 複製時沒有多餘空格或換行符
- 確認申請 OAuth 時有勾選流程所需的所有權限範圍
錯誤三：JSON 格式錯誤
症狀： 「Could not parse JSON」或「Unexpected token」，通常在 HTTP Request 節點或 Function 節點出現。
常見原因：
- JSON 格式有語法錯誤（多了或少了逗號、引號、括號）
- 在 Function 節點寫 JavaScript 時，把 JSON 格式當字串處理，沒有正確 parse
- 外部 API 回傳的不是標準 JSON，而是 HTML 或其他格式
排解步驟：
- 把 JSON 內容貼到 jsonlint.com 驗證格式
- 在 Function 節點中，確認使用
JSON.parse()和JSON.stringify()正確 - 在 HTTP Request 節點點開「Response」，查看實際收到的原始資料
錯誤四：Rate Limit（API 頻率限制）
症狀： 「429 Too Many Requests」，流程在高頻執行時出現。
常見原因： 每個 API 服務都有頻率限制，例如 Google Sheets API 每分鐘最多 60 個請求，OpenAI API 有 Token Per Minute 上限。當你的流程執行頻率超過限制，API 會拒絕請求。
排解步驟：
- 在高頻節點後加入「Wait」節點，設定適當的延遲（如每次執行後等 1-2 秒）
- 使用「SplitInBatches」節點把大量資料分批處理，避免一次性打爆 API
- 查看各 API 服務的官方文件確認頻率限制，調整流程的執行間隔
錯誤五：資料欄位找不到（undefined/null）
症狀： 節點顯示「Cannot read property of undefined」或欄位帶出空值，通常在引用上個節點資料時發生。
常見原因：
- 欄位名稱大小寫不一致（JSON 是 case-sensitive）
- 上個節點的資料結構改變了（如 API 更新），導致欄位位置不同
- 資料是陣列，但沒有用正確的方式取值（如需要
[0].fieldName但只寫了.fieldName）
排解步驟：
- 在問題節點前加入「Debug」節點（或執行並查看 Output），確認資料結構
- 使用 n8n 的「Expression Editor」，透過點選方式選擇欄位，避免手打欄位名稱錯誤
- 如果資料是陣列，確認使用正確的索引取值
錯誤六：流程執行超時
症狀： 流程執行到一半突然停止，沒有錯誤訊息，或顯示「Execution timed out」。
常見原因：
- 流程執行時間超過 n8n 的預設超時限制（雲端版預設較短）
- 等待外部 API 回應太久（API 服務本身很慢）
- 迴圈處理的資料量太大，執行時間過長
排解步驟：
- 自架版：在環境變數中調整
EXECUTIONS_TIMEOUT設定 - 把大型迴圈拆分成多個流程，用「Execute Workflow」節點串接
- 檢查慢速的 API 呼叫，考慮換用更快的服務或改用非同步模式
錯誤七：記憶體不足（自架版）
症狀： 伺服器上的 n8n 突然崩潰重啟，日誌顯示 OOM（Out of Memory）。
常見原因： 自架 n8n 使用太小的 VPS，同時執行多個複雜流程或處理大量資料時，記憶體耗盡。
排解步驟：
- 升級 VPS 規格（建議至少 2GB RAM，複雜 AI 流程建議 4GB 以上）
- 開啟 Swap 空間作為緊急記憶體緩衝
- 優化流程：避免一次性載入大量資料，改用分批（批次）處理
錯誤八：自架版升級後流程失效
症狀： 更新 n8n 版本後，某些節點行為改變或報錯，原本正常的流程突然出問題。
常見原因： n8n 版本更新有時包含 Breaking Changes，部分節點的欄位名稱或資料格式調整。
排解步驟：
- 升級前務必查看 n8n Release Notes，確認有無 Breaking Changes
- 升級前備份流程設定（Export All Workflows）
- 升級後逐一測試關鍵流程，而不是等到出問題才發現
「n8n 的錯誤 90% 都有跡可循，找不到原因通常是因為還沒看懂錯誤訊息在說什麼。」
預防大於治療
與其等流程壞了再排查，不如從一開始就建立好監控機制：
- 在每個關鍵節點後加入錯誤處理（Error Trigger），流程失敗時自動發 LINE 通知
- 定期查看 n8n 的「Executions」頁面，確認流程執行狀態
- 重要流程建立測試用的副本，先在副本上測試修改，確認正常後再更新正式流程
延伸閱讀
智賦 AI 科技 提供 n8n 流程健診與維護服務，協助企業建立完整的錯誤監控機制，確保自動化流程穩定運作。