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:
@@ -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