流程调试
流程跑出问题时，链盒提供了完整的可观测能力。本篇讲解如何定位和排查故障。
运行历史（Run History）
每次流程执行（无论成功还是失败）都会记录一次「运行」。在流程详情的「运行历史」中， 可以看到每一次运行的状态、触发时间、耗时、每一步的输入输出。
点击某次运行，进入执行详情：流程画布会高亮每个步骤的执行状态 （绿色成功 / 红色失败 / 灰色跳过），点开任一步骤可看到完整的输入数据和输出结果。 这是排查问题最常用的入口。
测试运行
在编辑模式下，可以用「测试」按钮跑一遍流程。测试运行使用真实数据（如最近的一条触发数据）， 但不会真正发送消息或写入生产数据（取决于动作是否启用「测试模式」）， 让你安全地验证流程逻辑。
常见错误类型
连接器认证失败
表现为步骤报 401/403。通常是凭证过期或权限不足。检查对应连接的配置， 重新授权或联系管理员补全权限。
变量引用为空
某个字段拿到空值导致后续逻辑出错。在执行详情里检查该步骤的输入， 确认上游输出结构是否与预期一致（字段名、嵌套层级）。
超时或限流
外部系统响应慢或调用频率超限。检查动作的超时设置，必要时增加重试或加延迟节流。
数据类型不匹配
比如把字符串传给了要数字的字段。用公式（toInt()、toJson()） 显式转换。
日志与告警
企业版支持配置失败告警：流程运行失败时自动通知指定人员（邮件/群消息）， 不必时刻盯着运行历史。建议为关键流程配置告警。
调试技巧
- 从失败步往前查：错误通常源于失败步骤的输入，往上追溯找到根因。
- 用测试触发器：调试时用一条固定的测试数据，便于复现问题。
- 临时加日志：在可疑步骤后插一个简单的 HTTP 动作把数据发到测试服务，查看中间值。
- 分而治之：复杂流程出错时，复制一份只保留前几步定位问题段落。