GUIDE · 自动化
自动化任务失败排查
定时自动化任务没跑、跑砸了、或者推送没收到，按什么顺序查？
展开本页目录
这篇攻略适合谁
- 定时任务没有按时触发，或触发了但输出为空
- 推送没收到、收到重复推送，或部分数据源缺失
开始前的准备
- 知道任务的名称与批次 ID（如 ai-hotspot-2026-07-10）
- 有 owner 与告警接收渠道（见第 26 章任务定义模板）
- 知道停用 / 手动重跑的入口
排查顺序
- 读告警先看告警里的批次 ID、状态、失败原因和已完成步骤；Blocked 状态说明任务被拦，未推送。
- 查数据源对照状态文件的 source_status，确认哪些数据源失败：超时可重试一次，限流按 Retry-After 等待，认证失效转人工。
- 查质量门禁有效条目不足或来源缺失过多会进入 warning / blocked；此时不推送正文是设计行为，不是故障。
- 查推送推送失败会保留结果并重试 2 次；确认推送目标可达、message ID 是否已记录。
- 决定重跑还是改配置临时故障：手动重跑，从断点续跑不重复推送；输入或配置问题：先修 Prompt / 数据源 / 推送配置，验证后再恢复定时。
重试还是转人工
| 失败类型 | 处理 |
|---|---|
| 数据源 API 超时 | 重试一次，仍失败标记缺失继续 |
| 限流（429） | 按 Retry-After 等待，最多 2 次 |
| 认证失效（401/403） | 转人工处理，不自动重试 |
| 推送目标不可达 | 指数退避重试 2 次，失败告警并保留结果 |
| 聚合结果为空 | 进入 blocked，推送说明，次日重新触发 |
别让重跑变成重复推送
每次运行有唯一批次 ID，推送成功后记录状态；重跑时检查状态、跳过已完成步骤——断点续跑从推送步骤继续，不重新抓取和聚合。手动触发与定时触发同时发生时，同样靠批次 ID 去重。
版本说明：功能与界面可能随更新变化
- 资料整理于 2026-09-21，参考资料保存于 2026-09-20。
- 以下内容尚未逐项确认，请以当前应用为准：自动化任务管理入口；计费口径。
确认问题已解决
- 告警信息能说清：批次、状态、失败原因、影响、建议处理
- 重跑后结果正确，且没有产生重复推送（幂等生效）
- 同类失败不再反复出现：临时故障重跑解决，配置问题已修配置
容易遇到的问题
- 对输入或配置问题反复重试——重试只针对临时性故障
- 推送失败就当任务没跑——结果应保留在状态文件里，可断点续跑
- 手动触发与定时触发叠加导致重复执行——用批次 ID 去重
- 告警只写「任务失败，请查看」——收到告警的人无法处理
关联内容
其他攻略：连接器与 Skill 授权失败排查 · 下载安装与登录问题排查