Skip to content

关于退回节点的操作控制 #270

Closed

Description

@xlorne

流程设计如下:

A-B-C-D,其中A为开始节点,D为结束节点,B和C都是审批节点,分别各自有两个审批人审核,对应b1 b2 ,c1 c2 审批模式为任意人审批。

操作流程如下:

当流程提交到了B节点之后,B节点退回时的界面上可选择的节点是不是只有A节点。

当流程提交到了C节点之后,C节点退回时的界面上可选择的节点是不是只有A、B节点。

另外假如当流程被退回到了A开始节点时,此时应该再界面上将无法再选择退回的操作了。

目前在项目框架上反馈说存在两个问题:

  1. 在各自节点上选择可退回的节点是全部节点,即可以跳跃到后面的节点上。这不应该发生的事情。
  2. 当被退回到A开始节点之后,再界面上还可以继续退回,我想这个问题应该是界面呈现上不对,正常开始节点无论是以那种形式返回过来的,展示可以操作的节点按钮应该都是开始节点的基础操作按钮。

另外,为了可以方便退回的操作,退回展示的可选择节点列表应该是上一个节点再第一条,例如在C时退回时,可选择的节点列表应该是B、A,而不是A和B。

Activity

  1. xlorne commented on Nov 16, 2026

    @xlorne
    ContributorAuthor

    感谢反馈,已按你的流程(A 开始 → B 审批 b1/b2 → C 审批 c1/c2 → D 结束)定位完成,先同步问题原因与处理方案。

    一、问题原因

    1. 退回候选节点越界(能选到后面的节点)

    前端「退回节点」下拉的候选列表,是从流程定义的全量节点里“截取到当前节点为止”,而不是当前记录真实走过的历史节点:

    • flow-frontend/packages/flow-pc/flow-pc-approval/src/plugins/view/return-view.tsx(移动端 flow-mobile-approval 同构):遍历 state.flow.nodes,遇到 state.flow.nodeId 就 break;
    • state.flow.nodes 由后端 FlowContent.pushWorkflow()(flow-engine-framework/.../pojo/response/FlowContent.java)输出,取的是 workflow.getNodes(),即只包含顶层节点;而节点查找 FlowNodeManager.getFlowNode() 是递归 blocks 的,两者口径不一致;
    • 因此当当前节点位于条件/并行块内时,currentId 匹配不到顶层节点 → 循环永不 break → 候选列表退化为全部展示节点,可以跳到后续节点;未经分支/从未执行过的节点同样会进入列表。

    服务端目前也兜不住:ActionManager.verifySession()(flow-engine-framework/.../manager/ActionManager.java)对 ReturnAction 只校验“非结束节点 / 非当前节点 / 非下游节点(workflow.isNextNode)/ 类型白名单”,不校验目标是否真实执行过。并行、条件分支下“结构上不是下游、但实际没走过”的节点仍可通过校验。

    另外,后端其实已有 Workflow.getNackNodes() + BackNodeHelper(node/helper/BackNodeHelper.java)在收集退回候选节点,但生产代码零引用,且它按定义顺序收集,同样没有“最近优先”。

    2. 退回到开始节点后仍能继续退回

    • 开始节点默认动作只有「通过 / 保存」(StartNode.defaultActions()),退回到 A 时 StartNode.generateCurrentRecords() 还执行了 newRecord() + cleanAction(),记录本身是干净的;
    • 但设计器的 TabNodeLayout(flow-frontend/packages/flow-design/src/components/design-editor/node-components/layout/index.tsx)对所有节点开放「按钮配置」页签,开始节点 nodes/start/form-meta.tsx 用的就是它,因此可以给开始节点加一个“退回”动作,运行期 BaseFlowNode.setActions() 会照常生效 → 按钮在 A 上被渲染出来;
    • 而 A 的任何目标都是下游,提交时 verifySession 必然抛 backNode 校验错误,表现就是“按钮还在、点了必然失败”,即你说的界面呈现不对。

    3. 候选顺序是 A、B 而不是 B、A

    同第 1 条:列表按流程定义顺序截取,没有按执行历史倒序,所以离当前最近的上一节点不会排在第一条。

    二、影响范围

    • 后端:flow-engine-framework — 详情未提供“可退回节点”,ActionManager.verifySession() 缺少历史校验;
    • 前端:codingapi/flow-frontend — PC flow-pc-approval、移动端 flow-mobile-approval 的 return-view;设计器 flow-design 开始节点的按钮配置;
    • 涉及动作:退回(RETURN)。拒绝(REJECT)走拒绝脚本选目标节点,不在此次范围内。

    三、处理方案

    1. 后端输出可退回节点:FlowContent 新增 backNodes 字段,基于当前记录的真实执行链(FlowRecordService.findFlowRecordBeforeRecords())倒序去重(最近优先,天然满足 B、A 顺序),仅保留 START / APPROVAL / HANDLE,排除当前节点与未走过的节点;复用已有 NodeOption 结构,不新增机制,也不动现有 nodes 字段。
    2. 后端校验对齐:ActionManager.verifySession() 对 ReturnAction 增加“目标必须存在于当前记录的历史执行链”校验,保留现有的非结束节点 / 非当前节点 / 非下游 / 类型白名单校验。
    3. 前端消费:PC 与移动端 return-view 改为使用 backNodes;列表为空时不再渲染退回入口(开始节点即属于此情况),不再从 nodes 自行截取。
    4. 设计器:开始节点隐藏 / 禁用「退回、拒绝」这类运行期必然失败的动作配置(是否直接隐藏「按钮配置」页签会一并评估)。
    5. 兼容性:仅新增 backNodes,nodes 保持原样,对已有集成无破坏;ActionManager 的收紧只影响“退回到未执行节点”这一非法路径,正常流程不受影响。

    四、交付方式

    • 基于 dev 的特性分支:codingapi/flow-engine → feature/issue-270-return-node-control;codingapi/flow-frontend → feature/issue-270-return-node-control;
    • 完成后只推送特性分支,不合并 dev,是否合并由维护者决定;修复提交会带 Closes #270;
    • 本条为定位回复,本次暂无代码提交;修复分支推送后会在此同步提交号与验证结果。
  2. xlorne commented on Nov 16, 2026

    @xlorne
    ContributorAuthor

    补充更正上一楼定位中的第 2 条(“退回到开始节点后仍能继续退回”)。

    结论:默认配置下不复现,需要更正

    我用单元测试在本地做了验证(A 开始 → B 审批 b1/b2 或签 → C 审批 c1 → D 结束;c1 从 C 退回开始节点 A):

    • 退回到 A 后,A 待办的记录为 nodeId=<开始节点>、nodeType=START、actionType=null;
    • /detail 返回的 actions / actionList 为开始节点自身的动作(通过、保存,测试工程另有自定义动作),不包含 RETURN;
    • 原因为 StartNode.generateCurrentRecords() 生成退回后的新记录时执行了 newRecord() + cleanAction(),不会继承上游节点的退回动作。

    也就是说:引擎默认行为是正确的,正常 UI 在开始节点不会渲染“退回”,上一楼把这条写成缺陷是我的误判,抱歉。

    能复现这条现象的唯一路径

    把 RETURN 动作配置在开始节点自身上:

    • 设计器 TabNodeLayout(flow-frontend/packages/flow-design/src/components/design-editor/node-components/layout/index.tsx)对所有节点都开放「按钮配置」页签,开始节点也能加“退回”;
    • 保存接口 /api/cmd/workflow/save 走 Workflow.formJson(),节点 actions 原样反序列化,实测开始节点加载结果为 [PASS, SAVE, RETURN];
    • 此时开始节点确实会渲染退回按钮,但:候选节点列表为空(return-view 遍历到第一个节点即 break),即使强行提交,ActionManager.verifySession() 的 isNextNode 判断也会拒绝 —— 表现为“按钮在、提交必失败”。

    另一种情况是接入方自定义 UI 固定渲染退回入口、并用全量 nodes 自行拼候选列表,这会同时放大第 1 条现象。

    方案调整

    1. 第 1 条(候选节点越界、可跳后续节点)与第 3 条(顺序应为 B、A)保持不变:后端新增 backNodes(基于真实执行链倒序去重、最近优先),前端改用它并在为空时不渲染退回入口;
    2. 第 2 条从“缺陷”调整为“配置/接入侧的防御性兜底”:
      • 设计器侧:开始节点不再提供「退回 / 拒绝」这类运行期必然失败的动作配置(或直接隐藏按钮配置页签);
      • 后端侧:ActionManager.verifySession() 增加“开始节点不支持退回”的明确校验(复用现有校验风格),避免把校验失败落到泛化的 backNode 错误上。
    3. 其余(nodes 字段保持兼容、特性分支交付方式)不变。

    如你在某个具体流程里确实看到了“退回到开始节点后还能继续退回”,麻烦把该流程的设计 JSON(/api/query/workflow 导出)提供一下,我按该定义复现确认——大概率是开始节点被配置了退回动作,或使用了自定义审批页。

  3. xlorne commented on Nov 16, 2026

    @xlorne
    ContributorAuthor

    修复已完成并推送特性分支(未合并 dev,是否合并由维护者决定)。

    修复内容

    1. 退回候选节点改为「真实执行历史 + 最近优先」(对应诉求 1、3)

    • 详情响应新增 backNodes:只包含当前记录真实执行过的历史节点,按记录 id 倒序去重后输出,天然满足"最近的上一节点排第一"(停留在 C 节点时得到 B、A),并自动排除当前节点、未执行的分支节点、结束节点;
    • 原 nodes 字段(流程定义全量节点)保持不动,对已有集成无破坏;
    • 没有可退回节点时(开始节点),actions 不再下发退回按钮,避免"按钮可点但提交必然失败"的交互(对应诉求 2)。

    2. 服务端校验收紧,不再只依赖前端

    • ActionManager.verifySession() 对退回新增两条校验:开始节点不支持退回;退回目标必须存在于当前记录的历史执行链;
    • 此前只校验"非结束 / 非当前 / 非下游 / 类型白名单",并行、条件分支中"结构上不是下游但从未执行"的节点可以被强行退回,现在会被拒绝(node.notSupportReturn / node.backNode.notInHistory)。

    3. 前端改为消费后端候选列表

    • flow-types 新增 backNodes;
    • 新增 buildReturnNodeOptions(@coding-flow/flow-approval-presenter),PC 端与移动端 return-view 统一使用,不再从流程定义节点中截取;
    • 兼容旧版后端:缺失 backNodes 字段时回退到原逻辑。

    4. 顺带修复

    • BaseAction.show() 兼容缺少 display 配置的旧流程数据(导入的历史流程在详情接口会空指针)。

    验证结果

    • 后端 ./mvnw -o -pl flow-engine-framework test:375 个用例通过(新增 FlowIssue270ReturnNodeControlTest 3 个:历史候选与最近优先、未执行分支拒绝、开始节点不展示退回);
    • 后端 ./mvnw -o install -DskipTests:全模块编译通过;
    • 前端 pnpm -F @coding-flow/flow-approval-presenter test:102 个用例通过(新增 return-nodes 5 个);
    • 前端 build:flow-pc-approval、build:flow-mobile 构建通过;
    • test:flow-pc-approval / test:flow-mobile-approval 存在 act(...) is not supported in production builds of React 的失败,属于本地环境既有问题,dev 基线相同文件、相同数量失败,与本次改动无关。

    代码提交

    升级提示

    • 后端升级后,并行的「条件分支中未执行节点」将无法再作为退回目标(此前可通过接口强行退回,属缺陷行为);
    • 前端与后端建议同步升级以获得"最近优先"的候选顺序;仅升级前端时仍走兼容逻辑。
  4. xlorne commented on Nov 16, 2026

    @xlorne
    ContributorAuthor

    补充:前端已升级版本到 0.2.21,并锁定到该特性分支。

    • changeset version 按 fixed 模式把全部 @coding-flow/* 包从 0.2.20 统一升到 0.2.21(flow-types / flow-core / flow-icons / flow-approval-presenter / flow-pc-ui / flow-pc-form / flow-pc-approval / flow-mobile-ui / flow-mobile-form / flow-mobile-approval / flow-design),包间依赖保持 workspace:*;
    • 各包 CHANGELOG.md 已生成 0.2.21 段落(含本次 backNodes 改动与 Updated dependencies);
    • 已消费并删除 .changeset/issue-270-return-back-nodes.md,避免下次发版重复叠加;
    • pnpm-lock.yaml 无需变更(内部依赖为 workspace 引用);
    • 全量包构建通过(11 个包 dist 均生成成功)。

    代码提交

    升级提示:接入方升级前端到 0.2.21 后,退回候选节点由后端 backNodes 驱动(最近优先);后端未升级时仍走兼容逻辑,但无法获得历史过滤与最近优先排序。

  5. added a commit that references this issue on Nov 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions