# P2-LIKE 注入修复报告:保真层 GeneralPO 值位置单引号转义 > 日期:2026-06-11 | 工作线:platform-legacy-core 保真层 > 工程:eip4-platform/platform-legacy-core(JDK17) > 来源:P4-4 picker 衔接报告 §坑8.8 定位的注入点;架构设计 §四「安全四层」第 2 层「渐进参数化」的 LIKE 路径项 > 数据源:本地 M0 PG `localhost:5433`;对拍专用库 `eip4like`(本次重建,幂等自举);服务端口 **8091**(验证后已 kill) --- ## 一、一句话结论 保真层 SQL 引擎 `GeneralPO` 的 String 搜索值裸拼 LIKE 注入点(`col like '%值%'`)及同形态 5 处值位置裸拼,统一过 `StringUtil.escapeSqlLiteral`(**只把 `'` 双写为 `''`,绝不转义通配符 `%`/`_`**)。对合法值(含中文/空格/含 `%` 的通配搜索)逐字节零行为变化,注入载荷被降级为字面量。单测 7/7,全模块 `mvn install` + ArchUnit 绿,ParityCli `--all`(21 实体)+ `--privilege`(9 正例/3 负例)全一致,REST 实测注入负例返回 200 空结果(不注入、不报错、表未被 DROP)。 **真参数化(PreparedStatement `?` 占位)作为 P2 后续热点项保留**——本次范围仅为保真层最小改动「值转义堵注入面」,不改引擎拼接形态。 --- ## 二、注入点清单(全文件 grep 同类裸拼点登记) 文件:`platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java` | 行 | 拼接形态 | 值来源 | 用户可控 | 本次处置 | |----|---------|--------|---------|---------| | **1940** | `col + " like '%" + obj.toString().trim() + "%'"` | String 列搜索值(`map.get(列名)`) | ✅ | **修(P4-4 热点)** | | 1982 | `col + " = '" + obj.toString() + "'"` | Object.class 列等值搜索值 | ✅ | **修(同形态明显点)** | | 1978 | `"'" + subId + "'"`(IN 列表元素) | Object.class 列 List 搜索值 | ✅ | **修(同形态明显点)** | | 2075 | `" ilike '%" + fuzzyCondition + "%' "` | 全表模糊查询条件(`FUZZY_QUERY`) | ✅ | **修(同形态 LIKE 点)** | | 2145 | `combidentifierCol + " like '%" + fuzzyCondition + "%' "` | 同上(多实体组合标识列) | ✅ | **修(同形态 LIKE 点)** | | 2173 | `displayColumnName + " like '%" + fuzzyCondition + "%' "` | 同上(关联实体显示列) | ✅ | **修(同形态 LIKE 点)** | | 1778 | `"'" + m_IDs[i] + "'"` | 记录主键 `m_IDs`(引擎内部置入,非搜索入参) | ❌ 非用户搜索值 | 不在本次范围 | | 1849/1858 | `TABLENAME = '" + get_TableName() + "'"` | 表名(元数据标识符,非值) | ❌ 标识符(白名单守,§安全第 1 层) | 不在本次范围 | | 2106 | 已注释死代码 | — | — | 无 | > 处置口径:本次只修「用户可控的**值位置**裸拼」。`m_IDs`(主键由引擎流程内部置入)与 `get_TableName()`(标识符,由现代层 `IdentifierWhitelist` 元数据白名单守,属安全第 1 层职责)不属本次「值转义」范围,登记备查。 --- ## 三、修复方式(严格遵守口径) ### 3.1 新增最小转义工具(复用既有单引号转义语义) `StringUtil` 已有 `TO_STRING(txt, maxLen)`:单引号双写 + **补外层 `'...'`**。LIKE 点需要值落在 `'%...%'` 内、通配符 `%` 须在引号外,因此不能直接用 `TO_STRING`(会多补一层引号、破坏拼接形态)。新增同语义但**不补外层引号**的方法(复用同一个 `QUOTE` 常量与 `''` 双写逻辑): ```java public static String escapeSqlLiteral(String txt) { if (txt == null) return null; if (txt.indexOf(QUOTE) < 0) return txt; // 无单引号原样返回(合法值零分配) StringBuilder out = new StringBuilder(txt.length() + 4); for (int i = 0; i < txt.length(); i++) { char c = txt.charAt(i); if (c == QUOTE) out.append("''"); // ' → ''(SQL 标准转义) else out.append(c); // % _ 及其余字符原样(保留通配语义) } return out.toString(); } ``` - **只转义单引号**(`'`→`''`):闭合引擎拼接的字符串字面量,堵注入。 - **绝不转义 `%` 和 `_`**:旧系统把搜索值里的 `%`/`_` 当通配符是既有行为;转义=改语义=破保真。保持通配语义原样。 - 不补外层引号:调用方原有 `'%` / `%'` / `= '` / `IN ('` 拼接形态零变化,diff 最小。 ### 3.2 6 处调用点改造(拼接形态不变,仅值过转义) ```java // 1940 String LIKE(P4-4 热点) sb.append(columnName + " like '%" + StringUtil.escapeSqlLiteral(obj.toString().trim()) + "%'"); // 1982 Object 等值 sb.append(columnName + " = '" + StringUtil.escapeSqlLiteral(obj.toString()) + "'"); // 1978 Object IN 元素 sb.append("'").append(StringUtil.escapeSqlLiteral(subId)).append("'"); // 2075 ilike 模糊 / 2145 combidentifier like 模糊 / 2173 displayColumn like 模糊 ... .append(" [i]like '%").append(StringUtil.escapeSqlLiteral(fuzzyCondition)).append("%' "); ``` ### 3.3 保真层改动纪律登记 - 改 `com.dsasp.*`(保真层),与 framework 源码 diff 控制到最小:`StringUtil` +32 行(1 个静态方法),`GeneralPO` 仅 6 处值位置各包一层 `escapeSqlLiteral(...)`,拼接结构与原 SQL 字符串形态一字未改。 - 不改 `PreparedStatement` 参数化(更大引擎改造)——真参数化列 **P2 后续热点项**(见 §六)。 - ArchUnit「保真层禁依赖现代层」不受影响(改动全在 `com.dsasp` 内,复用本包 `StringUtil`)。 --- ## 四、验证(过对拍——纪律) ### 4.1 单测(`StringUtilEscapeSqlLiteralTest`,7/7 通过) | 用例 | 断言 | |------|------| | 单引号双写 | `'`→`''`、`a'b`→`a''b`、`' OR '1'='1`→`'' OR ''1''=''1`、`'; DROP TABLE x--`→`''; DROP TABLE x--` | | 通配符不动 | `a%b`/`a_b`/`%`/`_`/`100%_done`/`a\b` 原样返回;`a'%b_c`→`a''%b_c`(只双写引号,`% _` 留) | | 正常值不变 | `张三`/`hello world`/`项目 A-2026`/中文+空格 逐字节不变;无引号值返回入参本身 | | null | 返回 `null` | | 拼接形态产物 | `P.NAME like '%'' OR ''1''=''1%'`(注入降级)、`P.NAME like '%a%b%'`(`%` 仍通配)、`P.ID = 'x''; DROP--'`、`IN` 元素转义 | ### 4.2 对拍(本地 8091 + eip4like 库) **行为保真 + 通配(REST `GET /api/entity/EIP4PT_CUSTOMER/list?NAME2=值`,String 列 NAME2 走引擎 `col like '%值%'` 路径)** 种子库灌入 3 条标定行:`NAME2='a%b'`(含字面 %)、`NAME2="O'Brien 中文"`(含单引号)、`NAME2='张三 项目'`(普通中文+空格)。 | 用例 | 结果 | |------|------| | `NAME2=张三`(中文) | HTTP 200 total=1,命中「张三 项目」 | | `NAME2='张三 项目'`(中文+空格) | HTTP 200 total=1,命中 | | `NAME2=a%b`(**含 % 字面通配保真**) | HTTP 200 total=1,命中「a%b」(% 仍按通配匹配) | | `NAME2=%`(**纯通配验证**) | HTTP 200 total=3(匹配全部非空 NAME2,证 % 是通配符**而非**被转义为字面量) | | `NAME2=O'Brien`(**含单引号字面**) | HTTP 200 total=1,命中「O'Brien 中文」(转义后字面匹配,不报错) | **注入负例(REST 实测留证)** | 载荷 | 结果 | |------|------| | `NAME2=' OR '1'='1` | HTTP 200 total=0(不返回全表,转义后字面查 0 行) | | `NAME2='; DROP TABLE x--` | HTTP 200 total=0;**表未被 DROP**(eip4pt_customer 仍 53 行) | | `NAME2=x' UNION SELECT * FROM sys_usergroup--` | HTTP 200 total=0(UNION 被降级为字面量) | | picker `?q=' OR 1=1--` | HTTP 200 `total:0`(status:0,干净) | **引擎实拼 SQL 留证**(app DEBUG 日志,证单引号被双写、载荷整体落在字面量内未闭合): ``` SELECT COUNT(*) AS COU FROM (SELECT P.EIP4PT_CUSTOMER_ID FROM EIP4PT_CUSTOMER AS P WHERE 1=1 AND P.NAME2 like '%''; DROP TABLE x--%') AS TEMPTABLE ``` `'; DROP TABLE x--` 的 `'` 被双写为 `''`,整条 payload 留在 `'%...%'` 字面量内,无语句中断、无 DROP 执行。app 日志无任何 `PSQLException`/`syntax error`。 **回归对拍** | 套件 | 结果 | |------|------| | ParityCli `--all`(本地 21 实体全量列表对拍) | 21/21 一致率=1.0000 OK,实体级一致率 1.0000 | | ParityCli `--privilege`(C2 行级权限) | 正例 9/9 全一致,负例 3/3 被拒(错误角色 → REJECTED),✅ 全部通过 | | `mvn -T1C clean install`(10 模块全量编译+单测+ArchUnit) | BUILD SUCCESS(含 ArchitectureRulesTest 1/1:保真层禁依赖现代层) | ### 4.3 全模块 BUILD SUCCESS ``` platform-legacy-core / platform-converter / platform-metadata / platform-auth / platform-flow-gateway / platform-ai / platform-parity / platform-app / flowable-service 全 SUCCESS;ArchitectureRulesTest Tests run: 1, Failures: 0 新增 StringUtilEscapeSqlLiteralTest Tests run: 7, Failures: 0 ``` --- ## 五、与 picker 端 `escapeLikeValue` 的口径区别(重要) P4-4 metadata 层 `PickerController.escapeLikeValue`(手册 §8.8)对 `q` **剔除** `%`/`_`/`\`(防通配符逃逸,现代层 picker 把搜索框定义为「不可作通配」优先保安全)。本次保真层 `escapeSqlLiteral` **保留** `%`/`_`(保真层职责是「行为对合法值零变化」,旧系统通配语义不能动)。两者是**不同层、不同语义**: - 现代层 picker `q`:业务定义为模糊关键字,转义器主动剔通配符(产品决策)。 - 保真层引擎 LIKE sink:必须保通配语义(保真硬约束)。 二者最终都汇到本次修的同一引擎 sink;本次修复让该 sink 对**任何**进来的值都堵单引号注入(picker 已先剔通配再进来,entity filter 等其它入口的值则保通配进来),双管不冲突。 --- ## 六、真参数化后续项(P2 热点,本次未做) 本次为保真层**最小改动**:只在值位置加单引号转义堵注入面,保持字符串拼接形态。架构设计 §四第 2 层「渐进参数化」、§五「计划缓存抖动(头号性能税)」的根子级修复——把热点路径值位置改 `?` 占位(PreparedStatement)——是更大的引擎改造,**列 P2 后续热点项**: - 优先级 = C3 压测热点 ∩ 安全风险点(架构 §五「关键协同」)。 - 一次参数化同时还安全(结构稳定不可注入)+ 性能(PG 计划缓存可复用)两笔债。 - 改造时仍须「每改一处过对拍」(本报告的对拍套件可直接复用)。 在此之前,本次的单引号转义是**可回归的注入兜底**(对拍负例守着不退化),等价于把架构 §四第 4 层「检测兜底」的注入负例从一次性人工保证变成 ParityCli/单测断言。 --- ## 七、git 提交(只 add 本线自有文件) - `platform-legacy-core/src/main/java/com/dsasp/server/common/util/StringUtil.java`(+`escapeSqlLiteral` 静态方法) - `platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java`(6 处值位置过转义) - `platform-legacy-core/src/test/java/com/dsasp/server/common/util/StringUtilEscapeSqlLiteralTest.java`(新增单测) - `platform-legacy-core/P2-LIKE注入修复报告.md`(本报告) - `docs/迁移手册.md`(§8.10 新坑)