n8n 故障排查与常见问题

n8n 报错有个共同点：真正的原因往往不在报错信息里。节点报「凭证无效」，可能是接口改了字段；报「超时」，可能只是对面限流。所以这一页不按报错字母排序，而是按排查顺序整理。

先按这四步走

第一步，确认数据到没到节点。点开出错节点左边的连接线，看上一节点输出的条目长什么样。很多「节点配置错了」其实是上游根本没给数据，或者给的是空数组。

第二步，看是数据问题还是连接问题。把节点单独执行一次（节点面板里的「执行步骤」），如果单独跑能过、整个工作流跑不过，问题就在上游数据；如果单独跑也报错，才去查配置和凭证。

第三步，读原始响应。HTTP 类节点报错时，展开错误详情看状态码和响应体。401 和 403 是两回事，429 说明被限流，要退避重试而不是改参数。

第四步，看执行记录。执行列表里能看到每个节点的输入输出和耗时，找出第一个出错的节点，而不是最后那个红色的。后面全是因为前面没给数据。

留言时带上这些信息，能被更快定位：n8n 版本（设置页能看到）、节点类型和版本、报错原文、上一节点的输出结构（把敏感字段去掉）、是手动执行报错还是定时执行报错。只说「跑不通」，没法判断。