文档中心
搜索
全部文档
文档中心工作流常见问题与排查

常见问题与排查

本章适用于工作流设计、发起、任务处理和运行异常。先根据现象定位，再检查对应配置；修正后用一笔测试业务确认结果。

先确认问题发生在哪一步

  • 保存或发布失败：查看设计器底部的校验结果，点击提示定位配置。

  • 点击发起后没有流程：检查已发布版本、启动参数、业务键和操作权限。

  • 有待办但页面没有内容：检查任务跳转参数与 UX 的取值、查询方式。

  • 点击完成后数据不对：分别检查业务数据保存、任务回传参数和节点数据映射。

  • 运行到某节点报错：在流程监控中定位该实例、节点和作业信息，再按下文处理。

反馈问题时，请提供发生时间、工作流名称、流程实例 ID、任务实例 ID（如有）、报错节点和完整错误信息。日志中的 Cookie、Token、业务敏感数据应先脱敏。

Python 脚本节点报 401 或 UNAUTHORIZED

现象与处理位置

Python 日志出现 APIResponseError、code: 401 或 UNAUTHORIZED。例如定时启动的流程调用 Python，Python 再访问平台组件时失败。

统一在被调用的 Python 脚本入口中处理，使用 DeepFOS Python 官方异常说明 中与实际 SDK 版本对应的配置。仅刷新浏览器登录状态，不能作为定时运行脚本的长期解决办法。

线上运行：修改 Python 入口

  1. 打开节点实际关联的 Python 元素，进入“元素设置”，找到“内网执行”，点击旁边的设置图标可查看并复制配置代码；同时确认执行入口及运行环境中的 deepfos SDK 版本。

  2. 若 SDK 大于等于 1.1.77，将以下配置放在入口最上方。

  3. 配置必须先于任何 DeepFOS 元素类、API 类的导入；若其他业务模块间接导入这些类，也要先配置，再导入业务模块。

  4. 保存 Python 元素，按当前环境的脚本发布方式使修改生效，再用原调用方式复测。

上图说明配置入口。复制代码后需要粘贴到脚本入口最前面才会生效；截图中的 ServiceDiscovery 是较早版本的写法，具体代码请按下面的 SDK 版本说明选择。

Copy
from deepfos import OPTION

OPTION.discovery.enabled = True
OPTION.discovery.take_over = True

# 在以上配置之后，再导入所需的 DeepFOS 元素类、API 类及业务模块。

SDK 在 1.1.7 至 1.1.77 之前、或 低于 1.1.7 时，服务发现配置不同。请使用官方说明中对应版本的完整方案，不能只把旧版 Eureka 示例复制到所有环境。

该配置面向平台线上运行环境。若改后出现服务发现、服务地址或连接错误，请交由环境管理员核对服务注册和网络，不要把所有错误都继续当作登录过期处理。

本地调试

本机运行时，按官方说明更新 debug 文件中的 para1 参数，并确认调试配置先于 DeepFOS 业务模块生效。不要把本地登录凭证写入共享文档或长期固定到线上脚本。

怎样确认修复

用同一个 Python 元素和原有流程调用方式验证：组件调用不再报 401；同步调用能返回节点定义的输出；异步调用还要到 Python 作业中确认实际执行结果。对有写入、发送通知等副作用的脚本，重试前先检查上次是否已部分完成。

保存或发布时校验失败

点击底部校验项，按提示检查节点、连线、必填参数和引用元素。修改后重新保存或发布；确认发布成功后，再从 UX 发起一笔新流程验证。保存设计稿并不等于更新已发布的流程版本。

UX 页面打开了，业务数据却为空

按传递顺序检查：

  1. 工作流的用户任务是否启用待办跳转界面，且关联了正确的 UX。

  2. 跳转参数名称是否与 UX 中 $urlQuery 的属性名一致，注意大小写。

  3. 业务参数是否来自有值的启动参数或全局变量。

  4. UX 数据源的查询条件是否使用该参数，是否有权读取这条业务记录。

  5. 是否从待办的实际任务打开页面。直接在编辑器预览时，通常没有这条任务的 URL 参数。

例如工作流传 contract = wfi$contract_id，UX 就读取 $urlQuery.contract；参数名不会自动改成 contract_id。配置步骤见 工作流打开 UX 与传参。

业务表单有内容，任务处理控件却为空

业务记录和任务是两种对象，需要分别定位。业务编号不能填入“任务实例 ID”；任务实例 ID 来自用户任务的 acp$task_id，流程实例 ID 来自 wfp$proc_id。

检查控件查询方式、传入 ID、当前用户与任务关系、任务是否已完成，以及是否开启了相应的后备查询。一个流程可能有多条任务，不能用流程 ID 代替任务 ID。详见 任务处理与结果回传。

完成任务后，下一个节点拿不到 UX 回传值

UX“完成任务所需参数”进入当前任务的 acr$extra_res。例如回传参数名为 approved_amount，在当前节点读取 acr$extra_res.approved_amount，再通过数据映射写入全局变量 wfv$approved_amount，后续节点读取全局变量。

同时核对参数名、空值和类型。保存业务表单不会自动写入工作流变量；任务完成也不会自动保存业务表单。两者需要分别配置。

重新发布后，旧流程仍使用原来的配置

工作流有版本。先核对目标流程实例实际使用的版本，再检查本次修改是否已发布。用一笔新实例验证新配置；不要仅凭旧待办的效果判断新版本未生效。详见 流程发布与流程管理。

发起流程提示业务键重复

启用业务键唯一后，检查用于组合业务键的启动参数，以及同一业务是否已有进行中的实例。重复点击、按钮事件重复绑定也可能重复发起。业务编号、流程实例 ID 和业务键不一定相同，不要为绕开提示随意改变业务键。详见 从 UX 发起流程。

财务模型状态迁移报错

现象

节点作业信息包含“领域动作”“状态迁移异常”或 approval status。

自查步骤

  1. 查看财务模型节点实际传入的业务主键和事件。

  2. 查出这笔业务当前的状态，检查是否为空。

  3. 在状态迁移配置中，确认“当前状态 + 事件”存在有效组合。

  4. 根据业务事实修正数据或参数，再验证对应状态迁移。

通知节点失败，或出现 contact-empty

检查实际接收人、通知模板参数和节点完成规则。邮件接收人的邮箱为空时，作业信息可能出现 "toEmail":"contact-empty"。

如果业务要求所有人收到邮件，应补齐用户邮箱，并在使用 SystemUser 对象的场景执行“平台用户同步”，核对对象中的 email 已更新。

“全部成功”要求全部接收人发送成功；只有业务允许部分接收人成功就继续时，才选择“部分成功”。同时检查模板入参是否存在 null，按模板要求补齐，不要用更改完成规则掩盖必达通知失败。

Python 异步调用后，流程继续了但脚本未成功

异步调用成功表示脚本已被调起，不表示业务执行完成。需要等待结果的场景，应按 PY 脚本 和 最佳实践 配置“异步调用 + 等待消息”。核对等待节点的消息、目标流程实例和回传参数。

页面只显示“服务异常”

这是一类通用提示，不能仅凭这四个字确定原因。记录触发步骤、时间、实例 ID 和完整响应；结合流程作业信息与对应服务日志定位。若刚升级过环境，还需由管理员核对前后端组件版本和接口是否配套。

需要进一步咨询

功能咨询请说明“谁在什么页面做什么操作，期望看到什么结果”；方案咨询请补充流程图、参与角色、业务数据来源和例外情况。先用本章及 UX 配合使用 缩小问题，再提交脱敏资料。

上一篇：校验
下一篇：概述
本页目录

回到顶部

咨询热线

400-821-9199

© 2022 先胜云. All Rights Reserved.