fix(flow): 草稿保存关严格XSD校验(bpmn-js默认命名空间输出)+字节级DOCTYPE守卫保XXE
阶段2 live 验收阻断 bug:UI 保存草稿恒 422。根因=T2.1 评审 I-1 我把 enableSafeBpmnXml 从
false 改 true 时,convertToBpmnModel(source, validateSchema=true, ...) 的 validateSchema=true
开启严格 XSD 校验;bpmn-js saveXML 用默认命名空间(无前缀 definitions/process)重序列化,Flowable
严格 Xerces XSD 校验拒之(cvc-complex-type.2.4.a: element {MODEL}process ... expected)——bpmn-js
面向 BPMN 模型非字节级 XSD 合规,这是已知固有不兼容;原始 source(带前缀)故能过。
架构:草稿是可视化工具编辑的半成品,不该做完整 XSD 校验(完整校验属部署门 T3.1 ProcessValidator,
在解析后模型上跑,非 XSD)。修法:
1. parseGuard 的 convertToBpmnModel(..., true, true) → (..., false, true)(validateSchema=false)。
仍解析(非良构 XML 抛→422),不做严格 XSD。
2. XXE 不只靠此:解析前加字节级 DOCTYPE 拒绝守卫(移植 platform-report ReportXmlGuard
hasDoctypeInBytes/hasDoctype 模式,含 BOM/UTF-16 编码识别,就地复刻不引 platform-* 依赖),
与 enableSafeBpmnXml=true 双保险防外部实体注入。
测试(TDD 先红后绿):ProcessModelControllerTest 16→19——①bpmn-js 默认命名空间输出(BPMNDiagram
先于 process,触发同族 cvc-complex-type.2.4.a)改前 422 改后 200 落库(回归锚点,改前实测必红);
②含 <!DOCTYPE 声明的 XML → 422(XXE 守卫);③非良构 XML(标签不匹配)→ 关 XSD 后仍 422。
flowable-service 全模块 92 测试绿,BUILD SUCCESS,既有 16 测试零改动。
附带排查(T3.1 deploy 路径同问题,不在本 task 范围):Flowable 6.8.1 BpmnParse 构造器
validateSchema 默认 iconst_1=true,BpmnDeployer 把它传给 convertToBpmnModel → createDeployment()
.addString(bpmnJsXml).deploy() 会被同一 cvc-complex-type.2.4.a 咬。escape hatch:DeploymentBuilder
有 disableSchemaValidation()(仅跳 XSD)。T3.1 应:parse(validateSchema=false)→跑 ProcessValidator
(语义校验,计划已设计)→ createDeployment().disableSchemaValidation().addString().deploy()。
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>