# 运行与调试

打开工作流的运行记录，查看本次处理的状态、节点输入输出和日志。处理完成后，还应到目标知识库、数据表或文件卷检查结果。

## 查看一次运行

1. 选择需要检查的运行记录，确认工作流版本和输入资料。
2. 找到失败或输出不符合预期的节点。
3. 查看输入，确认字段、文件引用和参数是否正确。
4. 查看输出和日志，定位具体错误。
5. 输入有误时，回到上游节点检查输出和绑定；配置有误时，修改相应节点后重新运行。

## 常见问题

| 现象 | 检查与处理 |
| --- | --- |
| 节点长时间等待 | 查看运行记录中的状态和错误信息；持续等待时，将运行信息提供给管理员排查 |
| 提示输入缺失或字段为空 | 检查上游是否返回所需字段，以及下游绑定的字段名称是否一致 |
| 运行结果与画布预期不同 | 确认运行版本，检查节点顺序和输入绑定 |
| 子工作流无法调用 | 确认当前工作流中已定义对应子流程；启动另一条已发布工作流应使用工作流触发节点 |
| 文本处理节点拿不到正文 | 检查是否传入了文件 ID；先解析文件，再绑定解析结果中的正文或文档数组 |
| SQL 执行失败 | 检查 SQL 语法、目标表及引用字段，参见 [SQL 处理](nodes/code-processing/sql-processing.md) |
| 节点完成但业务结果不符合预期 | 检查输出数量、内容及目标位置；外部请求还需要检查响应状态码和业务响应 |

## 调整后再次运行

先用少量资料验证修改，逐步检查关键节点输出。涉及写入数据表、索引或文件时，重新运行前确认目标位置及覆盖设置，避免重复写入或覆盖需要保留的结果。

输入和状态引用方式见[变量与数据传递](variables-and-data.md)。