diff --git a/flowable-service/src/main/java/com/eip4/flowservice/api/BpmnIdSanitizer.java b/flowable-service/src/main/java/com/eip4/flowservice/api/BpmnIdSanitizer.java index 0d9d59e..3b24705 100644 --- a/flowable-service/src/main/java/com/eip4/flowservice/api/BpmnIdSanitizer.java +++ b/flowable-service/src/main/java/com/eip4/flowservice/api/BpmnIdSanitizer.java @@ -83,22 +83,31 @@ final class BpmnIdSanitizer { if (xml == null || xml.isEmpty() || idMap == null || idMap.isEmpty()) { return xml; } + // 反转前校验双射:idMap 值(净化 id)重复会让 inverse 静默覆盖 → 还原错。fail-fast + // (T2.1 起 idMap 从 metaInfo JSON 反序列化,损坏数据须炸不能静默还原成别的 key)。 Map inverse = new LinkedHashMap<>(); for (Map.Entry e : idMap.entrySet()) { - inverse.put(e.getValue(), e.getKey()); + String clash = inverse.put(e.getValue(), e.getKey()); + if (clash != null) { + throw new IllegalArgumentException("idMap 非双射:净化 id \"" + e.getValue() + + "\" 同时映射自 \"" + clash + "\" 与 \"" + e.getKey() + "\""); + } } return rewrite(xml, inverse); } - /** 逐个 id/引用类属性值按 {@code map} 精确替换(命中才换,未命中原样)。前缀安全:只锚定完整属性值。 */ + /** + * 逐个 id/引用类属性值按 {@code map} 精确替换(命中才换,未命中原样)。前缀安全:只锚定完整属性值。 + * 未改值的属性原样回写(append group(0) 原文),不重构 → 不归一 {@code id = "x"} 这类等号周围空白,保逐字节契约。 + */ private static String rewrite(String xml, Map map) { Matcher rw = ID_ATTR.matcher(xml); StringBuilder sb = new StringBuilder(); while (rw.find()) { - String attr = rw.group(1); String val = rw.group(2); String repl = map.getOrDefault(val, val); - rw.appendReplacement(sb, Matcher.quoteReplacement(attr + "=\"" + repl + "\"")); + String replacement = repl.equals(val) ? rw.group(0) : rw.group(1) + "=\"" + repl + "\""; + rw.appendReplacement(sb, Matcher.quoteReplacement(replacement)); } rw.appendTail(sb); return sb.toString(); diff --git a/flowable-service/src/test/java/com/eip4/flowservice/api/BpmnIdSanitizerTest.java b/flowable-service/src/test/java/com/eip4/flowservice/api/BpmnIdSanitizerTest.java index 2f309fd..b893364 100644 --- a/flowable-service/src/test/java/com/eip4/flowservice/api/BpmnIdSanitizerTest.java +++ b/flowable-service/src/test/java/com/eip4/flowservice/api/BpmnIdSanitizerTest.java @@ -160,4 +160,64 @@ class BpmnIdSanitizerTest { assertThat(BpmnIdSanitizer.restore(null, Map.of())).isNull(); assertThat(BpmnIdSanitizer.restore("", Map.of())).isEqualTo(""); } + + /** + * 生成的净化 id 不与文档内既有合法字面 id 冲突(used 占位契约)。 + * "审批".hashCode()&0x7fffffff 的 hex 恰为 b7af8 → 基名 "nb7af8" 与合法字面 id "nb7af8" 撞 + * → sanitize 须让 审批 映射为 nb7af8-2(否则 restore 会误改那个合法 id),restore 逐字节还原。 + */ + @Test + void 净化id不与既有合法id冲突_让位加序号() { + assertThat(Integer.toHexString("审批".hashCode() & 0x7fffffff)).isEqualTo("b7af8"); // 前置自证 + + String xml = """ + + + + + """; + + BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml); + + // 中文 id 让位到 -2;既有合法字面 id nb7af8 原样不动、不入 map + assertThat(r.idMap()).containsOnlyKeys("审批"); + assertThat(r.idMap().get("审批")).isEqualTo("nb7af8-2"); + assertThat(r.xml()).contains("id=\"nb7af8\""); + assertThat(r.xml()).contains("sourceRef=\"nb7af8\""); + assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml); + } + + /** + * M-1 逐字节契约:未改值的合法属性(含等号周围空白)须原样回写,不被重构归一。 + * 即便 map 非空(另有中文 id 被改),带空白的合法属性 round-trip 后原文不变。 + */ + @Test + void 未改值属性含等号空白_原样保留不归一() { + // legalTask 用 `id = "..."`(等号带空格)合法写法;审批 是被净化的中文 id → map 非空 + String xml = "" + + "" + + ""; + + BpmnIdSanitizer.Result r = BpmnIdSanitizer.sanitize(xml); + + // 审批被改;legalTask 的等号空白写法逐字保留(旧实现会归一成 id="legalTask") + assertThat(r.idMap()).containsOnlyKeys("审批"); + assertThat(r.xml()).contains("id = \"legalTask\""); + // round-trip 后原文逐字节不变 + assertThat(BpmnIdSanitizer.restore(r.xml(), r.idMap())).isEqualTo(xml); + } + + /** M-2 fail-fast:idMap 值(净化 id)重复=非双射(损坏 metaInfo),restore 抛而非静默还原错。 */ + @Test + void restore_idMap值重复_抛非双射异常() { + Map broken = new LinkedHashMap<>(); + broken.put("原A", "n1"); + broken.put("原B", "n1"); // 两个原 id 映到同一净化 id → 反转会静默覆盖 + String xml = ""; + + org.assertj.core.api.Assertions.assertThatThrownBy(() -> BpmnIdSanitizer.restore(xml, broken)) + .isInstanceOf(IllegalArgumentException.class) + .hasMessageContaining("非双射") + .hasMessageContaining("n1"); + } }