Files
eip4-platform/platform-legacy-core/P2-LIKE注入修复报告.md
zhengwr b9ad18f147 P2-LIKE: 保真层 GeneralPO 值位置单引号转义堵 LIKE 搜索注入
承 P4-4 §坑8.8 + 架构 §四安全第 2 层 LIKE 路径项。GeneralPO 对 String
搜索值裸拼 col like '%值%'(GeneralPO.java:1940)及同形态 5 处(Object 等值
1982/IN 1978/全表模糊 ilike 2075/like 2145/2173)无参数绑定 → 单引号闭合
字面量注入。

修复(保真层最小改动,严格口径):
- StringUtil 新增 escapeSqlLiteral:只把 ' 双写为 ''(SQL 标准转义堵注入)、
  绝不转义通配符 % _(旧系统通配语义保真)、不补外层引号(拼接形态零变化)
- GeneralPO 6 处用户可控值位置各包一层 escapeSqlLiteral,SQL 结构一字未改
- m_IDs(主键)/get_TableName()(标识符,白名单守)非值位置,不在本次范围
- 真参数化(PreparedStatement ?)列 P2 后续热点项,本次只堵值转义注入面

验证:单测 7/7;mvn install 10 模块 + ArchUnit 绿;ParityCli --all 21 实体
全一致 + --privilege 9 正/3 负全过;REST 8091 实测注入负例 200 空结果
不注入不报错(表未被 DROP),a%b/纯 % 仍通配。详见 P2-LIKE注入修复报告.md
+ 迁移手册 §8.10。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-06-11 17:26:05 +08:00

11 KiB
Raw Permalink Blame History

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 常量与 '' 双写逻辑):

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 处调用点改造(拼接形态不变,仅值过转义)

// 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 新坑)