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 d34ffd3..7a8a9b8 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
@@ -42,9 +42,11 @@ import io.swagger.v3.oas.annotations.tags.Tag;
*
存量隔离:本控制器建的草稿一律 {@code setCategory("eip4")},{@link #list()} 只查该分类,
* 库里 143 条老 shape act_re_model(旧 metaInfo + 可能悬空 editorSource)不进 Modeler 列表、避免打不开。
*
- * 写入前 XML 一律过 {@link BpmnXMLConverter} 解析守卫(validateSchema=true + enableSafeBpmnXml=true,
- * 后者关外部 DTD/实体解析,防 XXE/SSRF):坏 XML 返 422 且绝不落库;422 只回通用文案,原始解析原因仅进日志。
- * 守卫异常在本控制器就地 catch 转 422,不逸出到 {@code FlowExceptionHandler}(那里 FlowableException→400,语义不符)。
+ *
写入前 XML 一律过解析守卫({@link #parseGuard}):①字节级拒 DOCTYPE(XXE 门);②{@link BpmnXMLConverter}
+ * 以 {@code validateSchema=false}(草稿是半成品,不做严格 XSD——bpmn-js 默认命名空间输出与严格 XSD 已知固有不兼容,
+ * 完整校验属部署门)+ {@code enableSafeBpmnXml=true}(加固解析器,双保险防外部实体)解析。坏 XML 返 422 且绝不落库;
+ * 422 只回通用文案,原始解析原因仅进日志。守卫异常就地 catch 转 422,不逸出到 {@code FlowExceptionHandler}
+ * (那里 FlowableException→400,语义不符)。
* {@code from-procdef} 复用「按 procDefId 读部署 BPMN」逻辑(本控制器自带 {@link #readProcessModel} 小方法,
* 零改动 ProcessDiagramController)→ {@link BpmnIdSanitizer#sanitize} 净化中文 id → 建草稿,
* 原→净化映射连同源 procDefId/原 key 写进 metaInfo,供发布逆向还原。
@@ -62,6 +64,9 @@ public class ProcessModelController {
/** EIP4 草稿分类:建草稿时打此标,list() 只查此分类,隔离库里 143 条老 shape 存量 act_re_model。 */
static final String EIP4_CATEGORY = "eip4";
+ /** DOCTYPE 门 prolog 扫描字节上限(BOM/XML 声明/注释/DOCTYPE 都在最前)。 */
+ private static final int PROLOG_SCAN_BYTES = 8192;
+
private final RepositoryService repositoryService;
private final ObjectMapper objectMapper = new ObjectMapper();
@@ -229,16 +234,27 @@ public class ProcessModelController {
* BPMN 解析守卫:过则返回 {@code null}(放行),坏 XML 返回 422 ResponseEntity({status:1,msg})。
* 就地 catch 一切异常,不让引擎 XMLException/FlowableException 逸出到全局 advice(那里映射成 400,语义不符)。
*
- * {@code convertToBpmnModel(source, validateSchema, enableSafeBpmnXml)} 两布尔参:
- * {@code validateSchema=true} 走 BPMN 2.0 XSD 校验(拒非法结构);
- * {@code enableSafeBpmnXml=true} 启用 flowable 加固解析器(禁外部 DTD/参数实体/DOCTYPE),
- * 关掉 XXE/SSRF 面——校验路径也走加固解析器,不给外部实体注入留口。
+ * 两道关:①解析前字节级 {@link #hasDoctypeInBytes} 拒 DOCTYPE 声明(XXE 兜底,不依赖 flowable
+ * 内部 {@code supportDTD=false} 实现);②{@code convertToBpmnModel(source, validateSchema, enableSafeBpmnXml)}
+ * 解析——{@code validateSchema=false}:草稿是可视化工具编辑的半成品,不做严格 BPMN 2.0 XSD 校验。
+ * bpmn-js {@code saveXML} 用默认命名空间(无前缀 definitions/process)重序列化,Flowable 严格 Xerces XSD 校验
+ * 会拒({@code cvc-complex-type.2.4.a})——这是 bpmn-js(面向 BPMN 模型,非字节级 XSD 合规)与严格 XSD 的
+ * 已知固有不兼容;完整校验属部署门(T3.1 {@code ProcessValidator} 在解析后的模型上跑,非 XSD)。
+ * {@code validateSchema=false} 仍解析(非良构 XML 抛→422);{@code enableSafeBpmnXml=true} 保加固解析器
+ * (禁外部 DTD/参数实体/DOCTYPE),双保险关 XXE/SSRF。
*
* 422 只回通用文案;原始解析原因(可能含内部路径/实体细节)仅进 {@code log.warn},不回显给调用方。
*/
private ResponseEntity