流程设计如下: 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
xlorne commentedon Nov 16, 2026
感谢反馈,已按你的流程(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 上被渲染出来;verifySession必然抛backNode校验错误,表现就是“按钮还在、点了必然失败”,即你说的界面呈现不对。3. 候选顺序是 A、B 而不是 B、A
同第 1 条:列表按流程定义顺序截取,没有按执行历史倒序,所以离当前最近的上一节点不会排在第一条。
二、影响范围
flow-engine-framework— 详情未提供“可退回节点”,ActionManager.verifySession()缺少历史校验;codingapi/flow-frontend— PCflow-pc-approval、移动端flow-mobile-approval的return-view;设计器flow-design开始节点的按钮配置;三、处理方案
FlowContent新增backNodes字段,基于当前记录的真实执行链(FlowRecordService.findFlowRecordBeforeRecords())倒序去重(最近优先,天然满足 B、A 顺序),仅保留 START / APPROVAL / HANDLE,排除当前节点与未走过的节点;复用已有NodeOption结构,不新增机制,也不动现有nodes字段。ActionManager.verifySession()对ReturnAction增加“目标必须存在于当前记录的历史执行链”校验,保留现有的非结束节点 / 非当前节点 / 非下游 / 类型白名单校验。return-view改为使用backNodes;列表为空时不再渲染退回入口(开始节点即属于此情况),不再从nodes自行截取。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;xlorne commentedon Nov 16, 2026
补充更正上一楼定位中的第 2 条(“退回到开始节点后仍能继续退回”)。
结论:默认配置下不复现,需要更正
我用单元测试在本地做了验证(A 开始 → B 审批 b1/b2 或签 → C 审批 c1 → D 结束;c1 从 C 退回开始节点 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 条现象。方案调整
backNodes(基于真实执行链倒序去重、最近优先),前端改用它并在为空时不渲染退回入口;ActionManager.verifySession()增加“开始节点不支持退回”的明确校验(复用现有校验风格),避免把校验失败落到泛化的backNode错误上。nodes字段保持兼容、特性分支交付方式)不变。如你在某个具体流程里确实看到了“退回到开始节点后还能继续退回”,麻烦把该流程的设计 JSON(
/api/query/workflow导出)提供一下,我按该定义复现确认——大概率是开始节点被配置了退回动作,或使用了自定义审批页。xlorne commentedon Nov 16, 2026
修复已完成并推送特性分支(未合并
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 个用例通过(新增FlowIssue270ReturnNodeControlTest3 个:历史候选与最近优先、未执行分支拒绝、开始节点不展示退回);./mvnw -o install -DskipTests:全模块编译通过;pnpm -F @coding-flow/flow-approval-presenter test:102 个用例通过(新增return-nodes5 个);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基线相同文件、相同数量失败,与本次改动无关。代码提交
feature/issue-270-return-node-control@0bbe3ac971a3eaf0ba0cc542a4bbef86da7c9e13(PR:fix: 退回候选节点改为基于执行历史并收紧退回校验 (#270) #271)feature/issue-270-return-node-control@0b9b8d64b074ad412bb45241523c2bc773ed7b25(PR:待办合并办理【未实现,暂不影响】 #78)升级提示
xlorne commentedon Nov 16, 2026
补充:前端已升级版本到
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 引用);dist均生成成功)。代码提交
feature/issue-270-return-node-control@0bbe3ac971a3eaf0ba0cc542a4bbef86da7c9e13(PR:fix: 退回候选节点改为基于执行历史并收紧退回校验 (#270) #271,未变更)feature/issue-270-return-node-control@5b6f9c3e813fd15f237ce691f61a2bfdd9c9b0a3(PR:待办合并办理【未实现,暂不影响】 #78,含 0.2.21 版本升级)升级提示:接入方升级前端到
0.2.21后,退回候选节点由后端backNodes驱动(最近优先);后端未升级时仍走兼容逻辑,但无法获得历史过滤与最近优先排序。Merge pull request #271 from codingapi/feature/issue-270-return-node-…