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

@@ -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);
}
}