From 529f73f8f5ca02d3a4878cf9c356b8d0c995af14 Mon Sep 17 00:00:00 2001 From: zhengwr Date: Thu, 2 Jul 2026 13:48:36 +0800 Subject: [PATCH] =?UTF-8?q?fix(flow):=20=E5=8F=91=E5=B8=83=E9=97=A8?= =?UTF-8?q?=E5=9D=8Fkey=E5=9C=B0=E9=9B=B7=E6=94=B6=E5=8F=A3=E2=80=94?= =?UTF-8?q?=E2=80=94metaInfo=E4=B8=8D=E5=8F=AF=E8=AF=BBfail-fast(=E9=98=B2?= =?UTF-8?q?=E9=83=A8=E7=BD=B2=E5=87=80=E5=8C=96key)+=E5=8D=B1=E9=99=A9?= =?UTF-8?q?=E5=88=86=E6=94=AF=E8=A1=A5=E6=B5=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 评审 I1(高后果):readIdMap 把三种情况塌成「空 idMap→跳过还原」——(a)真新建 (b)JSON 解析失败 (c)解析成功但缺 eip4IdMap 键。对 from-procdef 存量草稿(editorSource 的 是净化 nXXX), (b)/(c) 会跳过还原 → 静默部署 key=nXXX 而非中文原 key(HTTP 200,违 D7,且与 restore 非双射 fail-fast 自相矛盾)。 修:readIdMap→resolveIdMap,据 from-procdef 写的 sourceProcDefId/originalKey 标记分流—— metaInfo 非空且(解析失败 或 带标记但缺/非-Map eip4IdMap)→ IllegalStateException fail-fast, deploy catch→422「草稿 id 映射不可用,无法还原原 key」,不部署。eip4IdMap 存在(含空 {})即可用 (空=全 ASCII 存量流程无需还原);真·新建(metaInfo {}/null、无标记)仍空 map 正常放行。impact 只读 最终回退 model.key(from-procdef 的 model.key 即中文原 key),不 500。 补测(评审 I2):非双射 idMap→IllegalArgumentException→422;存量草稿缺 eip4IdMap→422;metaInfo 坏 JSON→422; 存量空 eip4IdMap 全 ASCII 不误拒正常部署;deploy 路径字节级 DOCTYPE 守卫→422。Minor:M1 注释钉边界 (EIP4 语义校验在网关 ModelSemanticValidator/T3.2,此处仅引擎结构校验);M3 impact 注释说明为何不需独立 DOCTYPE 守卫。 ProcessModelControllerTest 30/30(19 既有零改动 + 11 T3.1:6 首轮 + 5 本轮);全 reactor clean install 绿 (ArchitectureRulesTest 6/6)。 Co-Authored-By: Claude Fable 5 --- .../api/ProcessModelController.java | 63 +++++++--- .../api/ProcessModelControllerTest.java | 113 ++++++++++++++++++ 2 files changed, 161 insertions(+), 15 deletions(-) diff --git a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java index 4db9634..56994c8 100644 --- a/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java +++ b/flowable-service/src/main/java/com/eip4/flowservice/api/ProcessModelController.java @@ -286,10 +286,11 @@ public class ProcessModelController { if (source == null) { return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿源为空,无法发布: " + id); } - Map idMap = readIdMap(model.getMetaInfo()); String deployXml; BpmnModel bpmnModel; try { + // resolveIdMap 在 try 内:存量草稿 metaInfo 不可读/丢 eip4IdMap 时 fail-fast(评审 I1),不静默跳过还原。 + Map idMap = resolveIdMap(model.getMetaInfo()); deployXml = prepareDeployXml(new String(source, StandardCharsets.UTF_8), idMap); // XXE 兜底:还原后 XML 再过字节级 DOCTYPE 守卫(与 parseGuard 同源防御);enableSafeBpmnXml 亦禁 DOCTYPE,双保险。 if (hasDoctypeInBytes(deployXml.getBytes(StandardCharsets.UTF_8))) { @@ -299,6 +300,10 @@ public class ProcessModelController { // validateSchema=false:bpmn-js 默认命名空间输出与严格 XSD 已知不兼容,语义交给下方 ProcessValidator; // enableSafeBpmnXml=true:加固解析器关外部实体/DTD。 bpmnModel = new BpmnXMLConverter().convertToBpmnModel(new StringStreamSource(deployXml), false, true); + } catch (IllegalStateException e) { + // resolveIdMap 的 fail-fast:存量草稿 metaInfo 不可读/丢 eip4IdMap,还原不出中文原 key→拒发,防落库 nXXX 坏 key(D7)。 + log.warn("[流程发布] id 映射不可用 id={}: {}", id, e.toString()); + return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿 id 映射不可用,无法还原原 key"); } catch (IllegalArgumentException e) { // BpmnIdSanitizer.restore 的 fail-fast:idMap 非双射(metaInfo 损坏)——须炸不能静默还原成别的 key。 log.warn("[流程发布] id 还原失败(idMap 损坏) id={}: {}", id, e.toString()); @@ -307,7 +312,8 @@ public class ProcessModelController { log.warn("[流程发布] BPMN 解析失败 id={}: {}", id, e.toString()); return status(HttpStatus.UNPROCESSABLE_ENTITY, "BPMN 解析失败"); } - // 引擎校验门:区分 ERROR/WARNING,只 ERROR 级阻断部署。 + // 引擎校验门:区分 ERROR/WARNING,只 ERROR 级阻断部署。此处仅引擎「结构」校验(节点连通/网关/多实例等); + // EIP4 「语义」校验(formKey 存在于 view_wftemplate、办理人/会签内嵌 JSON 白名单)在网关 ModelSemanticValidator(T3.2)。 List> blocking = new ArrayList<>(); for (ValidationError ve : processValidator.validate(bpmnModel)) { if (ve.isWarning()) { @@ -359,16 +365,19 @@ public class ProcessModelController { if (source == null) { return status(HttpStatus.UNPROCESSABLE_ENTITY, "草稿源为空: " + id); } - Map idMap = readIdMap(model.getMetaInfo()); String processKey; try { + // impact 是只读预览:resolveIdMap 抛(存量草稿 metaInfo 不可读)/半成品草稿解析失败,一律回退 model.key + // ——from-procdef 建草稿的 model.key 就是中文原 key(创建时 setKey(def.getKey())),回退即得正确 processKey, + // 不该因草稿未完成/元数据损坏而 500;真正阻断坏 key 部署由 deploy 端点 fail-fast 负责。 + // 无独立 DOCTYPE 字节守卫:impact 只查计数不部署,且 convertToBpmnModel 的 enableSafeBpmnXml=true 已禁 DOCTYPE/外部实体。 + Map idMap = resolveIdMap(model.getMetaInfo()); String deployXml = prepareDeployXml(new String(source, StandardCharsets.UTF_8), idMap); BpmnModel bpmnModel = new BpmnXMLConverter() .convertToBpmnModel(new StringStreamSource(deployXml), false, true); var mainProcess = bpmnModel.getMainProcess(); processKey = mainProcess != null ? mainProcess.getId() : model.getKey(); } catch (Exception e) { - // 解析失败(半成品草稿)回退 model.key:影响摘要是只读参考,不该因草稿未完成而 500。 log.warn("[流程发布] 影响摘要解析失败,回退 model.key id={}: {}", id, e.toString()); processKey = model.getKey(); } @@ -394,29 +403,53 @@ public class ProcessModelController { return BpmnIdSanitizer.restore(stripped, idMap); } + /** from-procdef 建草稿写入 metaInfo 的存量标记键(其一存在即表明本草稿源自既有流程定义,editorSource 是净化 XML)。 */ + private static final String[] FROM_PROCDEF_MARKERS = {"sourceProcDefId", "originalKey"}; + /** - * 从 metaInfo JSON 取 {@code eip4IdMap}(原→净化)。metaInfo 空 / 无该键(新建流程无净化)/ 解析失败 - * 一律返回空 Map(发布走「无 idMap 跳过还原」分支,key 原样部署)。 + * 从 metaInfo JSON 取 {@code eip4IdMap}(原→净化),供 {@link BpmnIdSanitizer#restore} 还原中文原 key。 + * + *

坏 key 地雷收口(评审 I1):绝不把「idMap 不可读」静默塌成「空 idMap→跳过还原」——那会让 from-procdef + * 存量草稿(editorSource 的 {@code } 是净化 {@code nXXX})在 metaInfo 损坏时静默部署出 key=nXXX 而非 + * 中文原 key(HTTP 200 无声,违 D7;且与 restore 非双射 fail-fast 自相矛盾)。据 from-procdef 写的 + * {@link #FROM_PROCDEF_MARKERS} 判存量草稿:

+ *
    + *
  • metaInfo 空/null → 真·新建,空 Map(跳过还原,key 原样)。
  • + *
  • metaInfo 非空但 JSON 解析失败 → 损坏,{@link IllegalStateException} fail-fast(调用方转 422)。
  • + *
  • 解析成功、{@code eip4IdMap} 存在(是 Map,含空 {@code {}})→ 直接用(空=全 ASCII 存量流程无需还原,正常)。
  • + *
  • 解析成功、{@code eip4IdMap} 缺失/非 Map 且带 from-procdef 标记 → 存量草稿丢了映射,无法还原原 key, + * {@link IllegalStateException} fail-fast(宁拒不发坏 key)。
  • + *
  • 解析成功、无 {@code eip4IdMap} 且无标记 → 真·新建(前端另存了别的 metaInfo),空 Map 正常放行。
  • + *
*/ - private Map readIdMap(String metaInfo) { + private Map resolveIdMap(String metaInfo) { if (metaInfo == null || metaInfo.isBlank()) { return Map.of(); } + Map meta; try { - Map meta = objectMapper.readValue(metaInfo, new TypeReference>() {}); - Object raw = meta.get("eip4IdMap"); - if (!(raw instanceof Map m)) { - return Map.of(); - } + meta = objectMapper.readValue(metaInfo, new TypeReference>() {}); + } catch (Exception e) { + // 非空 metaInfo 却解析不了=损坏,不能猜它是不是存量草稿→一律 fail-fast(宁拒不发可能的坏 key)。 + throw new IllegalStateException("metaInfo 无法解析,无法确认 id 映射: " + e, e); + } + Object raw = meta.get("eip4IdMap"); + if (raw instanceof Map m) { + // eip4IdMap 存在(即使空):空=全 ASCII 存量流程无需还原,直接用。 Map idMap = new LinkedHashMap<>(); for (Map.Entry e : m.entrySet()) { idMap.put(String.valueOf(e.getKey()), String.valueOf(e.getValue())); } return idMap; - } catch (Exception e) { - log.warn("[流程发布] metaInfo 解析失败,按无 idMap 处理: {}", e.toString()); - return Map.of(); } + // eip4IdMap 缺失/非 Map:带 from-procdef 标记=存量草稿丢了映射(editorSource 是净化 XML)→fail-fast 防坏 key。 + for (String marker : FROM_PROCDEF_MARKERS) { + if (meta.containsKey(marker)) { + throw new IllegalStateException( + "存量草稿 metaInfo 缺 eip4IdMap,无法还原净化 id 为中文原 key(marker=" + marker + ")"); + } + } + return Map.of(); // 无标记=真·新建,key 原样部署。 } /** diff --git a/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java b/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java index ce8958d..f7fd1f6 100644 --- a/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java +++ b/flowable-service/src/test/java/com/eip4/flowservice/api/ProcessModelControllerTest.java @@ -611,6 +611,119 @@ class ProcessModelControllerTest { .andExpect(jsonPath("$.status").value(1)); } + @Test + void 发布_非双射idMap_restore_fail_fast返422不部署() throws Exception { + // metaInfo 的 eip4IdMap 两个中文原 id 映射到同一净化 id(n1)→restore 反转检测到非双射抛 IllegalArgumentException + // →deploy catch→422,绝不部署(损坏映射还原会指错 key)。 + Model m = Mockito.mock(Model.class); + when(m.getMetaInfo()).thenReturn("{\"eip4IdMap\":{\"总包合同交底\":\"n1\",\"其他流程\":\"n1\"}}"); + when(repositoryService.getModel("m1")).thenReturn(m); + when(repositoryService.getModelEditorSource("m1")) + .thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8)); + + MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class)); + localMvc.perform(post("/api/flow/models/m1/deploy")) + .andExpect(status().isUnprocessableEntity()) + .andExpect(jsonPath("$.status").value(1)) + .andExpect(jsonPath("$.msg").isNotEmpty()); + + verify(repositoryService, never()).createDeployment(); + } + + @Test + void 发布_存量草稿metaInfo缺eip4IdMap_fail_fast返422不部署() throws Exception { + // I1 坏 key 地雷:from-procdef 标记(sourceProcDefId/originalKey)在但 eip4IdMap 键丢了→editorSource 是净化 nXXX + // 却无从还原→绝不能静默塌成「空 idMap 跳过还原」部署出 key=nXXX(违 D7)→resolveIdMap fail-fast→422 不部署。 + Model m = Mockito.mock(Model.class); + when(m.getMetaInfo()).thenReturn("{\"sourceProcDefId\":\"def-1\",\"originalKey\":\"总包合同交底\"}"); + when(repositoryService.getModel("m1")).thenReturn(m); + when(repositoryService.getModelEditorSource("m1")) + .thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8)); + + MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class)); + localMvc.perform(post("/api/flow/models/m1/deploy")) + .andExpect(status().isUnprocessableEntity()) + .andExpect(jsonPath("$.status").value(1)) + .andExpect(jsonPath("$.msg").isNotEmpty()); + + verify(repositoryService, never()).createDeployment(); + } + + @Test + void 发布_metaInfo解析失败_fail_fast返422不部署() throws Exception { + // 非空 metaInfo 却是坏 JSON:无从确认是不是存量草稿→宁拒不发(可能的坏 key)→resolveIdMap fail-fast→422 不部署。 + Model m = Mockito.mock(Model.class); + when(m.getMetaInfo()).thenReturn("{坏JSON不可解析"); + when(repositoryService.getModel("m1")).thenReturn(m); + when(repositoryService.getModelEditorSource("m1")) + .thenReturn(DRAFT_SANITIZED_XML.getBytes(StandardCharsets.UTF_8)); + + MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class)); + localMvc.perform(post("/api/flow/models/m1/deploy")) + .andExpect(status().isUnprocessableEntity()) + .andExpect(jsonPath("$.status").value(1)); + + verify(repositoryService, never()).createDeployment(); + } + + @Test + void 发布_存量草稿eip4IdMap为空_全ASCII流程不误拒正常部署() throws Exception { + // 防 I1 修过头:from-procdef 的全 ASCII 存量流程 sanitize 出空 eip4IdMap {}(present),editorSource 本就是 ASCII key, + // 无需还原→eip4IdMap 存在(空)即「可用」,不该被 fail-fast 误拒→正常部署。 + Model m = Mockito.mock(Model.class); + when(m.getName()).thenReturn("ascii流程"); + when(m.getKey()).thenReturn("asciiKey"); + when(m.getMetaInfo()) + .thenReturn("{\"eip4IdMap\":{},\"sourceProcDefId\":\"def-1\",\"originalKey\":\"asciiKey\"}"); + when(repositoryService.getModel("m1")).thenReturn(m); + when(repositoryService.getModelEditorSource("m1")) + .thenReturn(VALID_BPMN.getBytes(StandardCharsets.UTF_8)); + + ProcessValidator validator = Mockito.mock(ProcessValidator.class); + when(validator.validate(any())).thenReturn(List.of()); + + DeploymentBuilder db = Mockito.mock(DeploymentBuilder.class); + when(repositoryService.createDeployment()).thenReturn(db); + when(db.disableSchemaValidation()).thenReturn(db); + when(db.name(any())).thenReturn(db); + when(db.addString(anyString(), anyString())).thenReturn(db); + Deployment dep = Mockito.mock(Deployment.class); + when(dep.getId()).thenReturn("dep-3"); + when(db.deploy()).thenReturn(dep); + ProcessDefinition deployed = Mockito.mock(ProcessDefinition.class); + when(deployed.getKey()).thenReturn("p1"); + when(deployed.getVersion()).thenReturn(1); + when(repositoryService.createProcessDefinitionQuery()).thenReturn(processDefinitionQuery); + when(processDefinitionQuery.deploymentId("dep-3")).thenReturn(processDefinitionQuery); + when(processDefinitionQuery.singleResult()).thenReturn(deployed); + + MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), validator); + localMvc.perform(post("/api/flow/models/m1/deploy")) + .andExpect(status().isOk()) + .andExpect(jsonPath("$.status").value(0)) + .andExpect(jsonPath("$.processKey").value("p1")); + + verify(db).deploy(); + } + + @Test + void 发布_editorSource含DOCTYPE_字节级XXE守卫返422不部署() throws Exception { + // deploy 路径自带的字节级 DOCTYPE 守卫(还原后 XML 再过一道):即便存储的 editorSource 含 DOCTYPE(理论不该, + // 因写入端已拒),部署也在解析前拒,绝不部署。 + Model m = Mockito.mock(Model.class); + // metaInfo 默认 null→真·新建分支,resolveIdMap 返空,prepareDeployXml 剥除+空还原=原样→deployXml 仍含 DOCTYPE。 + when(repositoryService.getModel("m1")).thenReturn(m); + when(repositoryService.getModelEditorSource("m1")) + .thenReturn(DOCTYPE_XML.getBytes(StandardCharsets.UTF_8)); + + MockMvc localMvc = deployMvc(Mockito.mock(RuntimeService.class), Mockito.mock(ProcessValidator.class)); + localMvc.perform(post("/api/flow/models/m1/deploy")) + .andExpect(status().isUnprocessableEntity()) + .andExpect(jsonPath("$.status").value(1)); + + verify(repositoryService, never()).createDeployment(); + } + /** 把任意字符串编成 JSON 字符串字面量(转义引号/反斜杠/换行),用于拼请求体。 */ private static String jsonString(String s) { StringBuilder sb = new StringBuilder("\"");