大家好，我是 N8N大学 的首席主编。在自动化领域摸爬滚打 8 年，我见过太多新手在面对 n8n 那红色的错误提示时，瞬间大脑一片空白。
其实，90% 的报错都不是什么“致命伤”，往往只是配置上的小疏忽。今天，笔者就手把手教你一套排查逻辑，当你遇到 n8n 工作流报错时，千万别慌，先查这三个地方。
一、查看节点的具体报错日志
很多新手看到工作流变红，只看到了“Execution failed”（执行失败），却没点开细节。这是最可惜的。
你需要点击那个报错的节点，在右侧的“Execution Data”面板中查看 Output。如果这里有输出，通常意味着数据传进来了，问题出在处理逻辑；如果没有输出，或者显示 Error，那么请重点关注以下两点：
- 参数缺失：比如 HTTP Request 节点的 URL 为空，或者 Set 节点的字段名填错。
- JSON 解析失败：当一个节点试图读取上一级的 JSON 数据时，如果路径写错（比如
$.user.id写成了$.users.id），节点就会直接报错。
笔者经验：n8n 的报错信息非常直白，通常会直接告诉你“Parameter missing”或者“Invalid JSON”。请逐字阅读它，这是解决问题的第一把钥匙。
二、检查节点的连接与执行顺序
n8n 采用的是数据驱动的流式处理。如果你发现工作流卡在某个节点，或者毫无反应，很可能是连接逻辑出了问题。
在这里，你需要排查两个核心概念：
- 单线 vs 多路分支：如果你在节点上拉出了多条线，n8n 会默认向所有连接的节点发送数据。但如果你只想在特定条件下触发，必须使用 IF 节点来分流。否则，数据流向了不该去的地方，就会引发数据格式冲突。
- 激活状态：在尝试测试自动化触发（如 Webhook）时，请务必点击画布右上角的 Active 按钮。很多“没反应”的报错，仅仅是因为工作流处于“未激活”状态。
特别注意：如果你使用了 Webhook 节点，请确保你的 n8n 域名是可以从公网访问的。如果是本地测试（localhost），外部请求是无法送达的，这会被 n8n 视为连接超时错误。
三、验证外部服务的凭证（Credentials）
这是新手最容易踩的坑，也是最隐蔽的坑。
当你的工作流涉及连接外部 API（如微信、钉钉、Slack、Google Sheets）时，凭证（Credentials） 的配置至关重要。如果凭证过期或权限不足，n8n 会在运行时报错，且错误代码通常是 401 Unauthorized 或 403 Forbidden。
你需要做的是：
- 点击报错节点右上角的小齿轮，进入 Credentials 设置。
- 检查 API Key、Token 或 Client ID 是否填写正确。
- 如果是 OAuth2 授权，留意授权是否过期，很多平台的 OAuth Token 需要手动刷新。
硬核技巧：在 Credentials 页面，通常有一个“连接”或“测试”按钮。点击它，如果能成功连接，说明凭证没问题；如果提示失败，请重新生成 API Key 再次填入。
FAQ：常见问题答疑
1. 为什么我的 HTTP Request 节点总是报 400 错误？
400 Bad Request 通常意味着请求格式不对。请检查你的 Body 是否是合法的 JSON 格式，或者 Header 中是否遗漏了 Content-Type: application/json。
2. 工作流运行成功了，但没达到预期效果，这是为什么？
这属于“逻辑错误”而非“执行错误”。请使用 n8n 的“Debugging”模式，逐个节点查看 Output，确认数据在每个节点的流转是否符合你的预期。
3. n8n 提示内存溢出（Out of Memory）怎么办？
如果你的数据量非常大（例如一次性处理几千条数据），可能会导致内存溢出。建议在工作流中加入分页逻辑，或者在 n8n 的 Docker 部署配置中增加内存限制（MAX_MEMORY）。
总结与资源
报错是自动化学习中最好的老师。记住口诀：一看日志、二查连接、三验凭证。
如果你在排查过程中遇到了具体的报错代码，欢迎访问 N8N大学 (n8ndx.com) 搜索更多实战案例。我是你的引路人，我们下期见。
