From b9ad18f147f6475685836291c1d514de2fd1dbe3 Mon Sep 17 00:00:00 2001 From: zhengwr Date: Thu, 11 Jun 2026 17:26:05 +0800 Subject: [PATCH] =?UTF-8?q?P2-LIKE:=20=E4=BF=9D=E7=9C=9F=E5=B1=82=20Genera?= =?UTF-8?q?lPO=20=E5=80=BC=E4=BD=8D=E7=BD=AE=E5=8D=95=E5=BC=95=E5=8F=B7?= =?UTF-8?q?=E8=BD=AC=E4=B9=89=E5=A0=B5=20LIKE=20=E6=90=9C=E7=B4=A2?= =?UTF-8?q?=E6=B3=A8=E5=85=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 承 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 --- docs/迁移手册.md | 12 ++ platform-legacy-core/P2-LIKE注入修复报告.md | 175 ++++++++++++++++++ .../dsasp/server/common/util/StringUtil.java | 32 ++++ .../dsasp/server/dataDic/bean/GeneralPO.java | 21 ++- .../util/StringUtilEscapeSqlLiteralTest.java | 114 ++++++++++++ 5 files changed, 348 insertions(+), 6 deletions(-) create mode 100644 platform-legacy-core/P2-LIKE注入修复报告.md create mode 100644 platform-legacy-core/src/test/java/com/dsasp/server/common/util/StringUtilEscapeSqlLiteralTest.java diff --git a/docs/迁移手册.md b/docs/迁移手册.md index b2a5499..98978b1 100644 --- a/docs/迁移手册.md +++ b/docs/迁移手册.md @@ -716,6 +716,18 @@ com.dsasp.* com.eip4.* | **对策** | 本期按「bootstrap SQL(本地/CI 自举)+ 生产建表脚本落 docs」落地:①`platform-metadata/src/main/resources/bootstrap/bootstrap-page-schema.sql`(`CREATE TABLE IF NOT EXISTS`,幂等,本地/CI psql 灌);②`docs/sql/SYS_PAGE_SCHEMA.sql`(生产建表脚本,注释里写明 P5 引 Flyway 时原样改名 `V{n}__create_sys_page_schema.sql` 即可,DDL 无需改);③导入 CLI `SchemaImportCli` 启动时 `CREATE TABLE IF NOT EXISTS` 兜底。**Flyway 引入列 P5 待办** | | **影响范围** | `platform-metadata`;P5 引 Flyway 时把 `docs/sql/*.sql` 收编为 migration;schema 接口 `GET /api/page/schema/{templateId}` 带 ETag/304(etag=schema_json 的 sha-256,入库时算),amis schema KB 级,304 省重复下发 | +### 8.10 保真层 GeneralPO 值位置裸拼 LIKE 注入:单引号转义堵注入面(真参数化列 P2 热点) [NEW 2026-06-11] + +| 栏目 | 内容 | +|------|------| +| **现象** | 承 §8.8——保真层 SQL 引擎 `GeneralPO.get_searchWhereWithPrefix` 对 String 列搜索值 `col like '%值%'`(GeneralPO.java:1940)及同形态 5 处(Object 等值 1982、Object IN 1978、全表模糊 ilike 2075/like 2145/2173)**裸拼无参数绑定**,值含单引号即可闭合字面量注入 | +| **根因** | 引擎值位置历史只在部分点经 `StringUtil.TO_STRING` 转义,但 LIKE 路径漏了——`TO_STRING` 会补外层 `'...'`,而 LIKE 需要值落在 `'%...%'` 内、通配符 `%` 在引号外,形态不匹配故当年未套用,遂成残余注入面 | +| **对策(本次落地)** | `StringUtil` 新增 `escapeSqlLiteral(txt)`:**只把 `'` 双写为 `''`(SQL 标准转义堵注入)、绝不转义通配符 `%`/`_`**(旧系统通配语义是既有行为,转义=改语义=破保真),且**不补外层引号**(拼接形态零变化,diff 最小)。`GeneralPO` 6 处值位置各包一层 `escapeSqlLiteral(...)`,SQL 字符串结构一字未改。**保真层最小改动**:合法值(含中文/空格/含 `%` 的通配搜索)逐字节零行为变化,注入载荷降级为字面量 | +| **关键区别** | 与 §8.8 picker 端 `escapeLikeValue`(**剔除** `%`/`_`/`\`,现代层产品决策「搜索框不可作通配」优先保安全)口径不同:保真层 `escapeSqlLiteral` **保留** `%`/`_`(保真硬约束)。二者不同层不同语义,最终汇到同一引擎 sink,本次修复让该 sink 对任何进来的值都堵单引号注入,双管不冲突 | +| **真参数化(后续)** | 本次仅值转义堵注入面,**未改 PreparedStatement `?` 占位**。架构 §四第 2 层「渐进参数化」+ §五「计划缓存抖动」的根子级修复(值位置改 `?`,一次还安全+性能两笔债)**列 P2 后续热点项**,优先级=C3 压测热点∩安全风险点,改造时仍须「每改一处过对拍」(本次对拍套件可复用) | +| **验证** | 单测 `StringUtilEscapeSqlLiteralTest` 7/7(`'`→`''`、`% _` 不变、中文/空格不变、null、拼接产物);ParityCli `--all` 21 实体全一致 + `--privilege` 9 正/3 负全过;REST 8091 实测 `' OR '1'='1` / `'; DROP TABLE x--` / UNION → 200 空结果不注入不报错(表未被 DROP),`a%b`/纯 `%` 仍按通配匹配(引擎实拼 SQL 留证:`like '%''; DROP TABLE x--%'` 单引号已双写、载荷落字面量内未闭合)。详见 `platform-legacy-core/P2-LIKE注入修复报告.md` | +| **影响范围** | `platform-legacy-core` `StringUtil.escapeSqlLiteral` + `GeneralPO` 6 处值位置;凡用户输入下推为引擎 String/Object 列搜索条件或 `FUZZY_QUERY` 模糊查询的入口(entity list / picker / 服务流查询)均经此 sink 受益 | + --- ## 九、待补章节占位 diff --git a/platform-legacy-core/P2-LIKE注入修复报告.md b/platform-legacy-core/P2-LIKE注入修复报告.md new file mode 100644 index 0000000..b66c572 --- /dev/null +++ b/platform-legacy-core/P2-LIKE注入修复报告.md @@ -0,0 +1,175 @@ +# 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 新坑) diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/common/util/StringUtil.java b/platform-legacy-core/src/main/java/com/dsasp/server/common/util/StringUtil.java index b016332..5bef18b 100644 --- a/platform-legacy-core/src/main/java/com/dsasp/server/common/util/StringUtil.java +++ b/platform-legacy-core/src/main/java/com/dsasp/server/common/util/StringUtil.java @@ -748,6 +748,38 @@ public class StringUtil { return out.toString(); } // TO_STRING + /** + * 值位置单引号转义(仅把 {@code '} 双写为 {@code ''},不加外层引号)。 + * + *

用途:保真层 SQL 引擎里值已被 {@code '...'} 包裹、但通配符 {@code %}/{@code _} + * 须留在引号外保持 LIKE 通配语义的拼接点(如 {@code col like '%值%'})。语义等价于 + * {@link #TO_STRING(String, int)} 的单引号转义部分,区别是不再补外层引号, + * 因此调用方原有的 {@code '%} / {@code %'} 拼接形态零变化。 + * + *

刻意不转义 LIKE 通配符 {@code %} 和 {@code _}:旧系统把搜索值里的 + * {@code %}/{@code _} 当通配符是既有行为,转义它们会改变查询语义、破坏行为保真。 + * 本方法只堵单引号闭合字面量的注入面,对所有合法值(含中文、空格、含 {@code %} 的 + * 通配搜索)产物与旧系统逐字节一致。 + * + * @param txt 原始值({@code null} 原样返回 {@code null},由调用方决定如何拼接) + * @return 单引号已双写、通配符与其余字符原样保留的值 + */ + 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("''"); + else + out.append(c); + } + return out.toString(); + } // escapeSqlLiteral + public static String convertSplitStrToSql(String txt) { if (txt == null || !txt.contains(",")) { return TO_STRING(txt, 0); diff --git a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java index e3fcdfa..782017a 100644 --- a/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java +++ b/platform-legacy-core/src/main/java/com/dsasp/server/dataDic/bean/GeneralPO.java @@ -1938,7 +1938,8 @@ public class GeneralPO implements GeneralPOJO, LogItem, Serializable { processListIn(sb, columnName, (List) obj, true); } else { sb.append(columnName + " like '%" - + obj.toString().trim() + "%'"); + + StringUtil.escapeSqlLiteral(obj.toString() + .trim()) + "%'"); } } else if (clazz == Object.class) { if (obj instanceof Map && ((Map) obj).size() > 0) { @@ -1975,11 +1976,15 @@ public class GeneralPO implements GeneralPOJO, LogItem, Serializable { } else { sb.append(","); } - sb.append("'").append(subId).append("'"); + sb.append("'") + .append(StringUtil + .escapeSqlLiteral(subId)) + .append("'"); } sb.append(") "); } else { - sb.append(columnName + " = '" + obj.toString() + sb.append(columnName + " = '" + + StringUtil.escapeSqlLiteral(obj.toString()) + "'"); } } else if (clazz == List.class && obj instanceof Map @@ -2072,7 +2077,8 @@ public class GeneralPO implements GeneralPOJO, LogItem, Serializable { whereBuffer.append(" OR "); } whereBuffer.append(pre).append(".").append(columnName) - .append(" ilike '%").append(fuzzyCondition) + .append(" ilike '%") + .append(StringUtil.escapeSqlLiteral(fuzzyCondition)) .append("%' "); } else if (clazz == Object.class && !p_info.isVirtualColumn(index)) { @@ -2143,7 +2149,9 @@ public class GeneralPO implements GeneralPOJO, LogItem, Serializable { } whereBuffer.append(subPre).append(".") .append(combidentifierCol).append(" like '%") - .append(fuzzyCondition).append("%' "); + .append(StringUtil + .escapeSqlLiteral(fuzzyCondition)) + .append("%' "); } } } @@ -2171,7 +2179,8 @@ public class GeneralPO implements GeneralPOJO, LogItem, Serializable { } whereBuffer.append(subPre).append(".") .append(displayColumnName).append(" like '%") - .append(fuzzyCondition).append("%' "); + .append(StringUtil.escapeSqlLiteral(fuzzyCondition)) + .append("%' "); } } } diff --git a/platform-legacy-core/src/test/java/com/dsasp/server/common/util/StringUtilEscapeSqlLiteralTest.java b/platform-legacy-core/src/test/java/com/dsasp/server/common/util/StringUtilEscapeSqlLiteralTest.java new file mode 100644 index 0000000..46e31e7 --- /dev/null +++ b/platform-legacy-core/src/test/java/com/dsasp/server/common/util/StringUtilEscapeSqlLiteralTest.java @@ -0,0 +1,114 @@ +package com.dsasp.server.common.util; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertSame; + +import org.junit.jupiter.api.DisplayName; +import org.junit.jupiter.api.Test; + +/** + * P2-LIKE 注入修复单测:{@link StringUtil#escapeSqlLiteral(String)} 值位置单引号转义。 + * + *

口径(严格遵守,见 docs/架构设计.md 第四节安全第 2 层 LIKE 路径 + P2-LIKE注入修复报告): + *

+ * + *

另含 GeneralPO 三处值位置拼接形态({@code col like '%值%'} / {@code col = '值'} / + * {@code IN ('值')})经转义后的产物断言——含单引号值被正确转义为字面量、含 {@code %} 值 + * 仍是通配。引擎级 where 拼接产物的端到端保真由 ParityCli 对拍覆盖(旧代码以对拍为完成定义)。 + */ +@DisplayName("StringUtil.escapeSqlLiteral:值位置单引号转义(% _ 不动)") +class StringUtilEscapeSqlLiteralTest { + + @Test + @DisplayName("单引号双写:' → ''") + void 单引号双写() { + assertEquals("''", StringUtil.escapeSqlLiteral("'")); + assertEquals("a''b", StringUtil.escapeSqlLiteral("a'b")); + assertEquals("''''", StringUtil.escapeSqlLiteral("''")); + // 经典注入载荷:闭合引号被双写后整体降级为字面量 + assertEquals("'' OR ''1''=''1", + StringUtil.escapeSqlLiteral("' OR '1'='1")); + assertEquals("''; DROP TABLE x--", + StringUtil.escapeSqlLiteral("'; DROP TABLE x--")); + } + + @Test + @DisplayName("通配符 % 和 _ 一律不转义(保留通配语义)") + void 通配符不动() { + assertSame("a%b", StringUtil.escapeSqlLiteral("a%b")); + assertSame("a_b", StringUtil.escapeSqlLiteral("a_b")); + assertSame("%", StringUtil.escapeSqlLiteral("%")); + assertSame("_", StringUtil.escapeSqlLiteral("_")); + assertSame("100%_done", StringUtil.escapeSqlLiteral("100%_done")); + // 反斜杠也不动(引擎 LIKE 无 ESCAPE 子句,转义反斜杠会改语义) + assertSame("a\\b", StringUtil.escapeSqlLiteral("a\\b")); + // 含单引号 + 通配符:只双写引号,% _ 原样 + assertEquals("a''%b_c", StringUtil.escapeSqlLiteral("a'%b_c")); + } + + @Test + @DisplayName("正常值逐字节不变:中文/空格/数字/常见符号") + void 正常值不变() { + assertSame("张三", StringUtil.escapeSqlLiteral("张三")); + assertSame("hello world", StringUtil.escapeSqlLiteral("hello world")); + assertSame("项目 A-2026", StringUtil.escapeSqlLiteral("项目 A-2026")); + assertSame("", StringUtil.escapeSqlLiteral("")); + assertSame("中文 with spaces 123", + StringUtil.escapeSqlLiteral("中文 with spaces 123")); + // 不含单引号时返回入参本身(无多余分配) + String noQuote = "abc%中文_def"; + assertSame(noQuote, StringUtil.escapeSqlLiteral(noQuote)); + } + + @Test + @DisplayName("null 原样返回 null(由调用方决定拼接)") + void null返回null() { + assertNull(StringUtil.escapeSqlLiteral(null)); + } + + // ---- 拼接形态产物断言:复刻 GeneralPO 三个值位置的拼接形状 ---- + + @Test + @DisplayName("LIKE 拼接:col like '%值%',单引号被转义、% 仍通配") + void LIKE拼接产物() { + String columnName = "P.NAME"; + // 含单引号的注入值:转义后整体落在 '...' 内,不闭合字面量 + String injected = "' OR '1'='1"; + String like = columnName + " like '%" + + StringUtil.escapeSqlLiteral(injected) + "%'"; + assertEquals("P.NAME like '%'' OR ''1''=''1%'", like); + + // 含 % 字面搜索值:% 留在引号外+内均不被转义,按通配匹配(保真) + String wildcard = "a%b"; + String likeWild = columnName + " like '%" + + StringUtil.escapeSqlLiteral(wildcard) + "%'"; + assertEquals("P.NAME like '%a%b%'", likeWild); + + // 正常中文值:产物与旧系统逐字节一致 + String normal = "系统"; + String likeNormal = columnName + " like '%" + + StringUtil.escapeSqlLiteral(normal) + "%'"; + assertEquals("P.NAME like '%系统%'", likeNormal); + } + + @Test + @DisplayName("等值拼接:col = '值',单引号被转义") + void 等值拼接产物() { + String eq = "P.ID = '" + StringUtil.escapeSqlLiteral("x'; DROP--") + + "'"; + assertEquals("P.ID = 'x''; DROP--'", eq); + } + + @Test + @DisplayName("IN 拼接:'值',单引号被转义") + void IN拼接产物() { + String in = "'" + StringUtil.escapeSqlLiteral("a') OR ('1'='1") + + "'"; + assertEquals("'a'') OR (''1''=''1'", in); + } +}