From b89447556f2e9b9560fcdaba9a19fe22bc619253 Mon Sep 17 00:00:00 2001
From: zhengwr
Date: Thu, 2 Jul 2026 11:32:26 +0800
Subject: [PATCH] =?UTF-8?q?fix(flow):=20=E8=8D=89=E7=A8=BF=E6=8E=A7?=
=?UTF-8?q?=E5=88=B6=E5=99=A8=E8=AF=84=E5=AE=A1=E6=94=B6=E5=8F=A3=E2=80=94?=
=?UTF-8?q?=E2=80=94safeBpmnXml+category=E8=BF=87=E6=BB=A4=E5=AD=98?=
=?UTF-8?q?=E9=87=8F+metaInfo=E4=BF=9D=E6=8C=81=E5=9B=9E=E5=BD=92=E6=B5=8B?=
=?UTF-8?q?=E8=AF=95=E7=AD=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
评审跟进 7 项(评审者反编译 Flowable 6.8.1 实证):
- I-1(安全):parseGuard convertToBpmnModel 第三参 enableSafeBpmnXml false→true,
启用 flowable 加固解析器(禁外部 DTD/参数实体/DOCTYPE)关 XXE/SSRF 面;javadoc 写明两布尔参语义。
- I-2(列表污染):库里 143 条存量 act_re_model(老 shape+悬空 editorSource)会进草稿列表打不开。
create/from-procdef 建 model 时 setCategory("eip4");list() 改 modelCategory("eip4") 只查本分类。
- I-3(回归契约):加「PUT 只带 name 不带 metaInfo→verify never setMetaInfo」用例,钉住 eip4IdMap
不被普通保存抹掉(T3.1 发布逆向还原原 key 的命根)。
- M-1:class javadoc 补「裸 8089 无鉴权,写端点必须经网关超管门访问(T2.2),生产 8089 不对外」。
- M-2:parseGuard 422 msg 改通用文案「BPMN 解析失败」,原始 e.getMessage 只进 log.warn(防内部细节回显)。
- M-3:POST create 对空白 name/key 返 422(key 是 T3.1 部署资源名/还原依赖),在解析守卫前拦;加测试。
- M-4:补 from-procdef「BPMN 读取为空(getProcessModel null)→found:false 不落库」分支测试。
测试:ProcessModelControllerTest 11→14 例(新增 空白 name/key 422 不落库、只带 name 不改 metaInfo、
BPMN 读空 found:false;既有列表用例补 modelCategory 断言、建草稿/from-procdef 补 setCategory 断言)。
flowable-service 全模块 87 测试绿(新增 3,既有其他模块测试零改动)。
Co-Authored-By: Claude Fable 5
---
.../api/ProcessModelController.java | 45 ++++++++++++---
.../api/ProcessModelControllerTest.java | 56 ++++++++++++++++++-
2 files changed, 91 insertions(+), 10 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 6636dc3..a9613c4 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
@@ -38,11 +38,18 @@ import io.swagger.v3.oas.annotations.tags.Tag;
* 不进部署库;发布(T3.1)时才 restore 中文原 key + 校验门 + deploy。act_re_model 表已有 143 行存量、schema 已在,
* {@code databaseSchemaUpdate=false} 不涉 DDL。
*
- * 写入前 XML 一律过 {@link BpmnXMLConverter} 解析守卫(validateSchema=true):坏 XML 返 422 且绝不落库。
+ *
存量隔离:本控制器建的草稿一律 {@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,语义不符)。
* {@code from-procdef} 复用「按 procDefId 读部署 BPMN」逻辑(本控制器自带 {@link #readProcessModel} 小方法,
* 零改动 ProcessDiagramController)→ {@link BpmnIdSanitizer#sanitize} 净化中文 id → 建草稿,
* 原→净化映射连同源 procDefId/原 key 写进 metaInfo,供发布逆向还原。
+ *
+ * 鉴权:本控制器随 flowable-service 跑在裸 8089,进程本身无鉴权栈;所有写端点
+ * (POST/PUT/from-procdef)必须经 platform-flow-gateway 的超管门访问(T2.2),生产环境 8089 不对外暴露。
*/
@RestController
@RequestMapping("/api/flow")
@@ -51,6 +58,9 @@ public class ProcessModelController {
private static final Logger log = LoggerFactory.getLogger(ProcessModelController.class);
+ /** EIP4 草稿分类:建草稿时打此标,list() 只查此分类,隔离库里 143 条老 shape 存量 act_re_model。 */
+ static final String EIP4_CATEGORY = "eip4";
+
private final RepositoryService repositoryService;
private final ObjectMapper objectMapper = new ObjectMapper();
@@ -60,9 +70,11 @@ public class ProcessModelController {
@GetMapping("/models")
@Operation(summary = "草稿列表",
- description = "createModelQuery().orderByLastUpdateTime().desc() → {models:[{id,name,key,lastUpdateTime(ISO)}]}。")
+ description = "createModelQuery().modelCategory(\"eip4\").orderByLastUpdateTime().desc() → "
+ + "{models:[{id,name,key,lastUpdateTime(ISO)}]}。只列 EIP4 建的草稿,隔离存量 act_re_model。")
public ResponseEntity