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