#1. 常见问题解答

---

#工作流无法触发

可能原因及解决方案：

• 工作流未发布：检查工作流状态，未发布的工作流不会自动执行，点击「发布」按钮激活工作流。
• 触发器配置错误：检查 Schedule Trigger 的时区设置，或 Webhook 节点的 URL 是否正确配置到了外部服务。
• 凭证失效：凭证的 API Key 或 OAuth Token 可能已过期，进入「背景设定 → 外部秘密」检查并更新凭证。
• 执行次数已用完：云端计划的月度执行次数已耗尽，需升级计划或等待下月重置。

#节点执行报错

常见错误类型及处理：

#Webhook 收不到数据

排查步骤：

1. 确认是否点击了「Listen for test event」（测试模式需要手动开启监听）。
2. 确认外部服务配置的是测试 URL（开发阶段）还是生产 URL（已发布的工作流）。
3. 检查外部服务的 Webhook 配置，确认 URL、请求方法和认证方式与 n8n 节点配置一致。
4. 使用 curl 或 Postman 手动向 Webhook URL 发送请求，验证网络连通性。
5. 在 n8n Cloud 中，确认 n8n 实例的访问地址是公网可达的（本地 localhost 无法被外部服务调用，需使用 ngrok 等工具进行隧道转发）。

#自托管实例升级后工作流不运行

在升级 n8n 版本后，如果工作流出现异常，建议：

1. 查看 n8n 的更新日志（Changelog），了解是否有破坏性变更（Breaking Changes）。
2. 检查相关节点是否有参数结构变化，及时更新配置。
3. 重新激活受影响的工作流（先停用再重新发布）。
4. 如问题持续，在 n8n 社区论坛（https://community.n8n.io）搜索是否有相同问题的讨论。

#表达式不生效或返回 undefined

常见原因：

• 引用的字段名拼写有误（字段名大小写敏感）。
• 前序节点未执行，没有数据可引用。
• 在 Run Once for All Items 模式的 Code 节点中，应使用 $input.all() 而非 $json。

调试方法：先执行前序节点，在输出面板的 JSON 标签中查看实际数据结构，再据此编写表达式。