请假审批画完了,最后拖了一个「抄送人」给相关部门。保存没报错,一点发布,有的环境先弹出:
节点 抄送人 包含未注册的执行委托属性,禁止通过 raw XML 绕过执行白名单。
把这一关放过去之后,Flowable 部署校验又甩出一句:
flowable-servicetask-invalid-type
流程图是设计器自己生成的,不是手改 raw XML。值班时很容易往两头猜:是抄送委托没注册,还是 serviceTask 根本不能这么写?
Forge Admin(开源后台,仓库见文末)里,抄送不是用户任务。设计器把「抄送人」写成 bpmn:serviceTask,带上 flowable:type="cc",并固定绑定已注册 Bean ${flowCcNodeDelegate}。这和引擎对 flowable:type 的约定撞车了:在 Flowable 里,这个属性是服务任务保留类型(mail、http 等),cc 不在名单里,默认 ProcessValidator 就会报 flowable-servicetask-invalid-type。更早一步,部署预检曾经把所有 delegateExpression 都当成未注册执行委托拒绝,连设计器自己写上去的抄送委托也被拦下。本文依据仓库 main(HEAD 45658ba75,2026-11-19 17:01 Asia/Shanghai)真实源码与提交。两处修复都在 2026-11-14:1a5120c62(14:15 Asia/Shanghai,预检放行已注册抄送委托)和 a62ef91c0(14:25 Asia/Shanghai,部署前把 flowable:type="cc" 改写为 flowable:forgeNodeType="cc")。CHANGELOG 把同一天的现场记成:含「抄送人」节点的审批流程可以正常发布,此前报未注册执行委托或 Flowable 服务任务类型非法。单测用 Flowable 默认 ProcessValidator 断言了原始 XML 会触发该校验、转换后错误数为 0。本轮未在运行环境再点一次发布,推断处标明「按源码推演」,发布前请作者自行点验。
查重:和已发的组织审批人发起补齐、转办幂等冲突、子表只读列字段权限、会签 completionCondition、驳回直送、条件分支公共节点合并都不是同一题。本篇不谈抄送接收人怎么解析、名单怎么落库,只谈含抄送节点的流程如何通过预检并完成部署。
TL;DR
- 现象(历史) :设计器拖了「抄送人」,保存成功,发布失败。先可能被预检拒绝,提示未注册的执行委托;放行之后,部署阶段再报
flowable-servicetask-invalid-type。含抄送的历史版本回退部署也会踩同一下。 - 根因 :设计器约定用
flowable:type="cc"识别抄送,并绑定${flowCcNodeDelegate}。旧预检把所有委托表达式都拒掉,连这条已注册 Bean 也不能过。即便预检过了,flowable:type仍是 Flowable 服务任务保留属性,cc不是合法类型,引擎部署校验失败。 - 改法 :预检只放行「
flowable:type=cc且委托恰好是${flowCcNodeDelegate}」的节点,其它 class / expression / 陌生 Bean 仍拒绝。发布和版本回退在交给引擎前,把flowable:type="cc"改写为flowable:forgeNodeType="cc";模型里保存的 XML 保持原样,供设计器继续识别,执行仍走同一个委托。
全景:设计器标记、预检白名单、部署时改写
Forge Admin 把「画布上怎么认抄送」和「引擎部署时能不能吃下这段 XML」拆开。前端 json-to-bpmn.js 给抄送节点写的是服务任务,不是用户任务:
| 环节 | 关键字段 | 作用 |
|---|---|---|
| 设计器写出 | flowable:type="cc" + flowable:delegateExpression="${flowCcNodeDelegate}" |
画布识别抄送,并固定绑定已注册 Bean |
| 部署预检 | validateExecutableNodesAndGatewayConditions |
只放行上述组合;脚本任务、子流程、未标明 type=cc 的 serviceTask、其它委托一律拒绝 |
| 交给引擎的 XML | toEngineExecutableXml |
把 flowable:type="cc" 改成 flowable:forgeNodeType="cc",委托表达式不动 |
| 模型库里的 XML | 不改写 | 设计器回读时仍按 flowable:type="cc" 认成抄送 |
| 运行时 | FlowCcNodeDelegate(@Component("flowCcNodeDelegate")) |
从节点上的 candidateUsers / candidateGroups 解析接收人并发送抄送 |
调用顺序值得单独记一笔:FlowModelServiceImpl 先跑预检,再改写,再交给 repositoryService 部署。预检看到的还是设计器 XML,白名单才能对上 type=cc;改写只作用于即将部署的那份文本。版本回退走 FlowModelVersionServiceImpl,注释写明:若不做同样的改写,含抄送的历史版本无法回退部署。

坑 1:设计器自己写的抄送委托,也被预检当成「未注册」
现象
按源码推演,含「抄送人」的模型一点发布,会先打在 validateExecutableNodesAndGatewayConditions 上。历史行为是:只要 serviceTask 带了 delegateExpression,就提示「包含未注册的执行委托属性,禁止通过 raw XML 绕过执行白名单。」设计器生成的 ${flowCcNodeDelegate} 并不例外。
根因(代码)
预检的本意是对的:不允许通过 raw XML 塞进任意 flowable:class、flowable:expression 或陌生 delegateExpression。旧逻辑把「有委托表达式」和「未注册」划了等号,没有给设计器抄送节点留白名单。
设计器侧其实写得很死。json-to-bpmn.js 对抄送节点固定输出类型和委托:
js
// json-to-bpmn.js(抄送节点分支,现网)
const DEFAULT_CC_DELEGATE_EXPRESSION = '$' + '{flowCcNodeDelegate}'
// ...
attrs.push('flowable:type="cc"')
// ...
attrs.push(`flowable:delegateExpression="${escapeXmlAttr(DEFAULT_CC_DELEGATE_EXPRESSION)}"`)
后端执行端也已经注册了同名 Bean:
java
// FlowCcNodeDelegate.java
@Component("flowCcNodeDelegate")
public class FlowCcNodeDelegate implements JavaDelegate {
// 执行时读取 candidateUsers / candidateGroups,调用 FlowCcService.sendCc
}
两边对得上,缺的是预检承认这个组合。单测 designerCarbonCopyNodeWithRegisteredDelegateIsAllowed 用的 XML 注释写明「与前端 json-to-bpmn 生成的抄送节点一致」。
怎么改
containsUnsupportedExecutionAttribute 现在只把「类型是 cc、委托表达式恰好是 ${flowCcNodeDelegate}、且该属性只出现一次」视为已注册抄送委托;其余仍拒绝:
java
// FlowModelBpmnPreflight.containsUnsupportedExecutionAttribute(现网)
boolean registeredCcDelegate = "cc".equalsIgnoreCase(attributeValue(attributes, "flowable:type"))
&& REGISTERED_CC_DELEGATE_EXPRESSION.equals(attributeValue(attributes, "flowable:delegateExpression"))
&& countMatches(normalized, "delegateexpression=") == 1;
return normalized.contains("flowable:class=")
|| (normalized.contains("flowable:delegateexpression=") && !registeredCcDelegate)
|| normalized.contains("flowable:expression=")
// 以及 activiti:class / delegateExpression / expression
同一方法配套的另外两条规则也很严:
- serviceTask 如果没声明
flowable:type=cc,即使委托写成${flowCcNodeDelegate},也会被拒绝,提示「未声明受支持的 flowable:type=cc」。 - 即便类型是 cc,只要带了
flowable:class、flowable:expression,或委托是${evilBean}这类陌生名字,仍提示未注册执行委托。
按源码推演,设计器正常拖出来的抄送节点可以过预检;想靠改 XML 把抄送委托换成任意 Bean,或者把普通服务任务伪装成抄送,仍过不去。
坑 2:预检过了,部署仍报 flowable-servicetask-invalid-type
现象
预检放行之后,发布还是可能失败,问题码是 flowable-servicetask-invalid-type。这不是 Forge 自己拼的文案,而是 Flowable 默认流程校验器给出的 problem 名称。按源码推演,含抄送的历史版本做回退部署时,如果只把模型库里的原 XML 交给引擎,会再踩一次。
根因(代码)
在 Flowable 里,flowable:type 是服务任务保留属性,用来声明 mail、http 这类内置类型。设计器用同一个属性存放业务标记 cc,引擎并不认识这个值。
单测 carbonCopyNodesAreRewrittenToEngineExecutableXml 没有只断言字符串被替换,而是把原始 XML 和转换后的 XML 都交给 Flowable 的 BpmnXMLConverter + ProcessValidatorFactory().createDefaultProcessValidator(),再按 error.getProblem() 是否等于 flowable-servicetask-invalid-type 计数:原始设计器 XML 至少 1 条,转换后为 0。这说明冲突来自引擎校验规则,不是发布接口自己误报。
怎么改
部署前增加一次只针对抄送标记的文本改写,委托表达式保持不动:
java
// FlowModelBpmnPreflight.toEngineExecutableXml(现网)
private static final Pattern CC_SERVICE_TASK_TYPE = Pattern.compile(
"(<(?:bpmn:)?serviceTask\\b[^>]*?\\s)flowable:type=\"cc\"", CASE_INSENSITIVE);
static String toEngineExecutableXml(String bpmnXml) {
if (bpmnXml == null || bpmnXml.isEmpty()) {
return bpmnXml;
}
return CC_SERVICE_TASK_TYPE.matcher(bpmnXml).replaceAll("$1flowable:forgeNodeType=\"cc\"");
}
两处调用点:
FlowModelServiceImpl:结构预检和可执行性预检之后、repositoryService部署之前。FlowModelVersionServiceImpl:版本回退部署前做同样转换,避免历史版本带抄送时回退失败。
单测还断言了三件对照事实:转换后文本不再包含 flowable:type="cc",出现的是 flowable:forgeNodeType="cc",${flowCcNodeDelegate} 仍在;并且把转换结果里的 forgeNodeType 换回 type 后,与原始 XML 一致。按源码推演,模型保存路径并不走这次改写,设计器下次打开仍按 flowable:type="cc" 识别抄送节点。运行时执行也不依赖这个类型名,而是走已注册的 FlowCcNodeDelegate。
发布前可收藏的自查清单
| # | 要核对的点 | 预期 |
|---|---|---|
| 1 | 设计器 XML 里抄送节点长什么样 | 应是 serviceTask,带 flowable:type="cc" 和 delegateExpression="${flowCcNodeDelegate}" |
| 2 | 发布时先过哪一关 | 先预检,再改写,再交给 Flowable 部署 |
| 3 | 预检报「未注册的执行委托」 | 先看委托是不是恰好 ${flowCcNodeDelegate},有没有额外的 class / expression |
| 4 | 预检报未声明 flowable:type=cc |
普通 serviceTask 即使写了抄送委托也会被拒,不要靠改委托绕过 |
| 5 | 部署报 flowable-servicetask-invalid-type |
看交给引擎的那份 XML 是否已改成 flowable:forgeNodeType="cc",模型库原件可以仍是 type |
| 6 | 版本回退 | 回退部署必须走同一套改写,否则含抄送的历史版本会再次失败 |
| 7 | 设计器再打开 | 模型保存的 XML 不应被改写,画布上仍应识别为「抄送人」 |
| 8 | 运行时抄送是否发出 | 执行仍由 flowCcNodeDelegate 完成,本篇不覆盖接收人解析;要单独核对候选用户/角色 |
| 9 | 单测 | designerCarbonCopyNodeWithRegisteredDelegateIsAllowed 与 carbonCopyNodesAreRewrittenToEngineExecutableXml 应绿 |
跟我对照:从拖入抄送到发布
假设请假流程在「部门审批」之后加了一个名为「抄送人」的节点,接收人是用户 1。按源码推演,当前 main 会这样走:
- 设计器写出
<bpmn:serviceTask ... flowable:type="cc" ... flowable:delegateExpression="${flowCcNodeDelegate}" ...>,回读时仍识别为抄送。 - 点发布。
FlowModelServiceImpl先校验连线和结构,再跑可执行性预检。当前预检承认「type=cc + 已注册委托」这一组合,不再报未注册执行委托。 - 预检通过后,
toEngineExecutableXml把即将部署的文本里的flowable:type="cc"改成flowable:forgeNodeType="cc",委托表达式不变。 - 这份转换后的 XML 交给 Flowable 部署。单测里,默认 ProcessValidator 对转换结果的
flowable-servicetask-invalid-type计数为 0。 - 流程运行到该节点时,引擎按
${flowCcNodeDelegate}找到FlowCcNodeDelegate,再解析接收人并发送抄送。 - 若从某个含抄送的旧版本回退,
FlowModelVersionServiceImpl会在部署前做同样的改写,而不是把模型库原件直接丢给引擎。
若停在 1a5120c62 之前:步骤 2 就会失败,提示未注册的执行委托,发布走不到部署。若只做了白名单、没有 a62ef91c0 的改写:步骤 2 能过,步骤 4 仍会被 Flowable 校验拦下,报标题里的 flowable-servicetask-invalid-type。若版本回退漏掉改写:新发布或许成功,回退旧版本时会再次失败。
系列说明与仓库
本文是 Forge Admin 审批设计器踩坑系列的一篇,只覆盖 含抄送节点的流程如何通过部署预检,以及如何避开 Flowable 对 flowable:type 的保留校验。前序可读:组织审批人发起时补齐变量、转办后的非终态幂等键、子表只读列字段权限、会签 completionCondition、驳回给发起人后的直送跳回、条件分支公共节点合并等。
- Gitee:gitee.com/ForgeLab/fo...
- GitHub:github.com/yaomindong1...
源码路径速查:
forge-admin-ui/src/components/flow-designer/converter/json-to-bpmn.js(写出flowable:type="cc"与默认委托)forge-admin-ui/src/components/flow-designer/constants/node-types.js(carbonCopy ↔ serviceTask)forge-server/.../FlowModelBpmnPreflight.java(预检白名单与toEngineExecutableXml)forge-server/.../FlowModelServiceImpl.java(先预检再改写再部署)forge-server/.../FlowModelVersionServiceImpl.java(版本回退部署前同样改写)forge-server/.../FlowCcNodeDelegate.java(@Component("flowCcNodeDelegate"))forge-server/.../FlowModelBpmnPreflightTest.java
若这篇帮你对上了「加了抄送,一点发布就报 flowable-servicetask-invalid-type」的现场,麻烦点个赞和收藏,少在发布按钮上卡一次。你在抄送接收人、待办快捷同意,或设计器里暂不支持发布的高级节点上还卡过哪一题?评论区丢给我,下一篇优先写读者票最高的坑。