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:
12
docs/迁移手册.md
12
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 受益 |
|
||||
|
||||
---
|
||||
|
||||
## 九、待补章节占位
|
||||
|
||||
175
platform-legacy-core/P2-LIKE注入修复报告.md
Normal file
175
platform-legacy-core/P2-LIKE注入修复报告.md
Normal 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 新坑)
|
||||
@@ -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);
|
||||
|
||||
@@ -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("%' ");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -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);
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user