执行日志与排障 ​

工作流日志是排查问题最重要的依据。

很多时候问题不是“流程有没有运行”，而是：

• 卡在了哪一步
• 哪个节点输入不对
• 哪个节点输出不对
• 是不是挂起后没有恢复
• 最终结果是不是被输出节点整理错了

后台先看哪里 ​

建议先看：

• 流程记录
• 日志详情

流程记录 ​

更适合先看“这次运行整体成功了没有”。

日志详情 ​

更适合继续看“到底是哪一个节点出了问题”。

日志文件默认在哪 ​

默认日志目录在：

data/logs/

工作流排查时常看哪些日志文件 ​

1. 先看工作流运行状态 ​

后台记录优先看：

• 流程记录
• 日志详情

如果你还想看文件日志，再继续看：

data/logs/ai.agent.log
data/logs/ai_scheduler.log

它们通常会帮助你判断：

• 是不是挂起了
• 调度器有没有继续轮询
• 恢复有没有成功

2. 如果是图片或视频能力 ​

继续看：

data/logs/ai.image.log
data/logs/ai.video.log

3. 如果是知识库或文件解析 ​

继续看：

data/logs/ai.rag.log
data/logs/ai.docs.log

排查时最推荐的顺序 ​

第一次排查时，建议按下面顺序看：

1. 先看这次流程是成功、失败还是挂起
2. 再看输入节点到底收到了什么
3. 再看中间能力节点执行了什么
4. 再看输出节点最终整理了什么
5. 如果是异步任务，再看调度和恢复日志

每次排查时重点看什么 ​

1. 看流程状态 ​

先判断这次运行属于哪种情况：

• success
• failed
• suspended
• resuming
• canceled

2. 看输入节点 ​

重点看：

• 实际传进来的输入是什么
• 字段名和你配置的标签是不是对应上了
• 有没有字段为空
• 有没有类型不对

3. 看能力节点 ​

重点看：

• 节点的输入是什么
• 节点执行后返回了什么
• 节点状态是不是挂起了
• 节点 message 写了什么

4. 看输出节点 ​

重点看：

• 输出节点接收到的输入是什么
• 最终返回了哪些字段
• 返回格式是不是前端或 API 需要的结构

最后给一个最简单的排查口诀 ​

你可以直接按这个顺序查：

先看状态，再看输入，再看中间节点，再看输出，最后看挂起和恢复。