问题自查与信息采集

建议的排查顺序

1. 记录问题发生阶段：保存、发布、调试、运行、定时执行或查看结果。

2. 再次执行相同操作，确认问题是否可以稳定复现。

3. 记录发生问题的数据流、节点名称和节点编码。

4. 收集对应后端接口的请求参数与响应结果。

5. 涉及组件服务节点时，补充节点日志或完整运行日志。

6. 收集数据流前端、后端和 deepfos 版本号。

7. 根据错误关键词查阅本章节的异常说明；无法解决时，将上述材料随工单提交。

收集后端接口信息

以调试失败为例，前端会调用名为 debug 的后端接口。保存数据流时通常会调用 update 接口，发布时通常会调用 deploy 接口，其他操作也可以用相同方法定位对应请求。

1. 按 F12 打开浏览器开发者工具。

2. 切换到 Network 页签，并清空已有请求记录。

3. 回到数据流页面，重新执行出现问题的操作。

4. 在 Network 中选择对应请求，分别记录 Payload 和 Response 页签内容；建议截图并随工单上传。

5. 右键请求，选择“复制”→“复制为 cURL（bash）”，将内容保存为文本附件。

收集组件服务调用日志

如果组件服务类型的节点报错，或结果与预期不符，仅查看 debug 接口通常无法获得数据流提交给组件服务的完整请求。可以在【设置-PY 设置】的公共脚本中临时加入以下配置：

from deepfos.options import OPTION

OPTION.api.dump_always = True
OPTION.general.log_level = "DEBUG"

具体配置入口参见全局设置。

保存后重新调试相关节点，节点日志会输出调用其他组件服务的详细信息和 cURL。请复制完整节点日志并随工单上传。也可以重新运行整个数据流，然后在运行历史中下载完整日志文件。

获取版本号

部分问题已在后续版本中修复，因此排查时需要同时提供数据流前端、后端和 deepfos 版本。最准确的版本信息可以由环境运维人员提供；如果项目环境允许，也可以按以下方式自行查看。

import deepfos

return deepfos.__version__

提交工单前检查清单

请尽量一次性提供以下信息：

• 问题现象、期望结果和实际结果；

• 可重复执行的操作步骤；

• 问题发生时间、数据流名称、节点名称和节点编码；

• 页面截图或录屏；

• 对应接口的 Payload、Response 和脱敏后的 cURL；

• 相关节点日志，必要时提供完整运行日志；

• 数据流前端、后端和 deepfos 版本号；

• 问题影响范围，以及是否存在临时绕过方式。