工作流节点多、链路长时，难免出现某个环节不按预期执行的情况。掌握节点状态含义与数据查看方法，可以快速定位失败节点并修复问题。
节点状态含义
点击编辑器顶部「运行」启动工作流后，各节点状态会实时更新：
| 状态 |
含义 |
| 等待中 |
上游尚未完成或尚未轮到该节点执行 |
| 运行中 |
节点正在执行，请勿中断 |
| 成功 |
节点执行完成，输出可用 |
| 失败 |
节点执行出错，流程在此中断或跳过该分支 |
查看节点输入输出
执行完成后，点击任意节点即可查看其输入和输出数据：
-
输入数据：确认上游变量是否按预期注入，字段名是否匹配
-
输出数据：确认节点产生的结果结构，为下游引用提供依据
- 历史运行记录保存在工作流列表的执行历史中，可回看每次运行的数据快照
定位失败节点的思路
-
从红色节点入手：找到状态为失败的节点，优先查看其错误信息
-
向上追溯：失败节点的输入异常，问题往往出在上游，检查前一个节点的输出
-
检查引用：
${节点标题.字段名} 拼写错误或节点重命名会导致取不到值
-
检查依赖：LLM、MCP 工具等节点依赖外部配置，确认对应服务已就绪
内置测试工具的使用
- JS 执行器节点支持编写 JavaScript 代码处理数据，可单独用小段代码验证逻辑
- 正则提取、随机值等节点逻辑简单，适合拆出来单独跑一遍验证规则是否正确
- 条件判断节点可分别触发两个分支，验证表达式在各种取值下的表现
- 建议分段测试：先跑通一小段链路，再逐步接入后续节点
常见排错检查清单
- [ ] 开始节点存在且唯一，是所有链路的起点
- [ ] 所有节点已连线，无孤立节点
- [ ] 被引用的节点标题与
${} 中的名称完全一致
- [ ] LLM、MCP 等外部依赖配置正确、服务可用
- [ ] 文件类节点（文件列表/复制/移动）的路径存在且有访问权限
本章相关文档
