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>
This commit is contained in:
2026-06-11 17:26:05 +08:00
parent e49b39f0cf
commit b9ad18f147
5 changed files with 348 additions and 6 deletions

View File

@@ -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 受益 |
---
## 九、待补章节占位

View File

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

View File

@@ -748,6 +748,38 @@ public class StringUtil {
return out.toString();
} // TO_STRING
/**
* 值位置单引号转义(仅把 {@code '} 双写为 {@code ''},不加外层引号)。
*
* <p>用途:保真层 SQL 引擎里值已被 {@code '...'} 包裹、但通配符 {@code %}/{@code _}
* 须留在引号外保持 LIKE 通配语义的拼接点(如 {@code col like '%值%'})。语义等价于
* {@link #TO_STRING(String, int)} 的单引号转义部分,区别是<b>不再补外层引号</b>,
* 因此调用方原有的 {@code '%} / {@code %'} 拼接形态零变化。
*
* <p><b>刻意不转义 LIKE 通配符 {@code %} 和 {@code _}</b>:旧系统把搜索值里的
* {@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);

View File

@@ -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("%' ");
}
}
}

View File

@@ -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)} 值位置单引号转义。
*
* <p>口径(严格遵守,见 docs/架构设计.md 第四节安全第 2 层 LIKE 路径 + P2-LIKE注入修复报告):
* <ul>
* <li>单引号 {@code '} → {@code ''}(SQL 标准转义,闭合引擎拼接的字面量,堵注入);</li>
* <li><b>绝不</b>转义 LIKE 通配符 {@code %} 和 {@code _}(保持旧系统通配语义,保真);</li>
* <li>正常值(含中文、空格、其它符号)逐字节不变(合法值零行为变化)。</li>
* </ul>
*
* <p>另含 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);
}
}