自动化流程出错，先按“触发、输入、节点、输出、日志”五个环节逐层检查：确认流程有没有被触发、数据有没有进来、节点逻辑是否报错、结果是否写出，再看日志定位，大多数故障都能快速锁定环节。
排错的第一步：确认触发了吗？
- 定时任务：检查时区配置，很多平台默认使用UTC时间；
- Webhook：确认地址没有变更、外部系统还在正常推送；
- 应用事件：检查授权是否过期，token失效是高频故障来源。
可以先看平台的执行记录列表：如果根本没有执行记录，说明问题出在触发层，后面的节点都不用查。
数据进来了吗？格式对吗？
在第一个节点后面接一个调试输出，查看实际收到的数据结构。常见问题包括：字段名大小写不一致、数组被当成对象处理、空值没有默认兜底。
节点报错怎么定位？
- 看错误信息中的状态码：4开头的多是鉴权或参数问题，5开头的多是服务端问题；
- 对单个节点手动执行，隔离上下游的影响；
- 用固定的测试数据复现，确认是数据问题还是逻辑问题。
输出环节查什么？
流程显示“成功”但结果不对，问题常在输出侧：写入权限不足导致静默失败、字段映射错位、重复执行造成多条记录。逐条比对输入和输出的记录数是否一致。
日志里要重点看什么？
- 时间线：触发时间与预期是否一致，时区错位常在这里暴露；
- 请求与响应体：字段是否缺失、格式是否变化；
- 重试记录：是否连续失败后停止，说明需要加退避策略。
日志保留期建议至少两周，排查“上周还好好的”这类问题全靠它。
怎么让排错更快？
- 开启执行日志并保留足够时长；
- 关键节点设置失败告警（邮件或IM通知）；
- 给复杂流程加“护栏”：重试次数、超时时间、异常分支。
搭建自动化流程的基础方法，可参考学习教程中的自动化专题；工具选型见AI工具导航。
常见问题FAQ
流程昨天还正常今天突然失败？
优先查两类原因：接口方升级或限流、授权token过期，这两者在日常故障中占比很高。
重复执行怎么防？
给每条数据加唯一ID并在写入前查重，重要操作做幂等设计，避免重试造成重复副作用。
报错信息看不懂怎么办？
把完整错误信息与执行日志一起交给AI助手分析，通常能快速给出可能原因清单，再逐条验证。
有没有办法提前发现问题？
给核心工作流加每日心跳任务：定时跑一条最小链路并推送通知，流程挂了当天就能知道，而不是等业务方投诉。
