PreparedStatement对MATCH AGAINST失效,因MySQL要求AGAINST后为编译期字面量;须白名单清洗关键词,剔除非法字符、压缩空格、校验引号配对,并严控布尔模式下的token安全。

MATCH AGAINST 本身不接受参数化,但拼接关键词仍可能被注入
MySQL 的 MATCH (col1, col2) AGAINST (? IN NATURAL LANGUAGE MODE) 语法中,AGAINST 后的搜索词**不能用 PreparedStatement 占位符替代**——这是 MySQL 原生限制。直接字符串拼接 AGAINST ('" + keyword + "') 就会触发 SQL 注入,尤其当 keyword 来自用户输入(如 GET 参数、表单字段)时。
为什么 PreparedStatement 对 MATCH AGAINST 失效
PreparedStatement 只能安全绑定列值(WHERE、INSERT VALUES 等),而 AGAINST 后的内容属于「全文检索表达式语法」,MySQL 解析器在预编译阶段就要求它是一个完整、合法的字符串字面量,不是运行时变量。所以以下写法会报错:
stmt = conn.prepareStatement("SELECT * FROM article WHERE MATCH(title, content) AGAINST(? IN NATURAL LANGUAGE MODE)");
stmt.setString(1, userInput); // ❌ 抛出 SQLException: Parameter index out of range本质是:MySQL 不允许把 AGAINST 的参数部分当作参数占位符处理。
立即学习“Java免费学习笔记(深入)”;
使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。
安全过滤关键词的三步实操
必须对用户输入的 keyword 做白名单清洗,而非简单转义。因为全文检索支持布尔操作符(+、-、>、、<code>( ))、通配符(*)和引号,这些字符若未经控制,可被用于构造恶意布尔逻辑或绕过限制。
- 只保留字母、数字、中文、空格、基础标点(
.,!?;:),其余一律剔除或替换为空格 - 连续空格压缩为单个空格,首尾空格 trim
- 禁用布尔前缀符号:
+、-、>、、<code>~、*(除非业务明确需要布尔模式且已做二次校验) - 若需支持短语搜索(带双引号),只允许成对出现的英文双引号,且内部禁止嵌套 SQL 关键字(如
"union select")
示例(Java):
public static String sanitizeFulltextKeyword(String input) {
if (input == null) return "";
// 先去除非预期符号(保留中文、ASCII 字母数字、空格及基础标点)
String cleaned = input.replaceAll("[^\u4e00-\u9fa5a-zA-Z0-9 .,!?;:"()]+", " ");
// 压缩空格
cleaned = cleaned.replaceAll("\s+", " ").trim();
// 移除孤立引号(不成对则删掉)
long quoteCount = cleaned.chars().filter(ch -> ch == '"').count();
if (quoteCount % 2 != 0) {
cleaned = cleaned.replace(""", "");
}
return cleaned;
}改用布尔模式时更需严控输入
若业务强制要求 IN BOOLEAN MODE(例如支持 +java -spring),就不能只靠正则清洗。此时应:
- 拆分关键词为 token(按空格、
+、-、>等分隔) - 对每个 token 单独调用
sanitizeFulltextKeyword()(去掉内部非法字符) - 拒绝含 SQL 关键字的 token(如
"select"、"union"、"or 1=1") - 限制总 token 数 ≤ 5,防止 DOS 式长查询拖垮索引扫描
错误示范:AGAINST('"+ keyword +"*' IN BOOLEAN MODE) —— * 通配符若未校验,用户输 a* or b* 就可能改变语义;正确做法是先 clean 再拼接,且只在可信 token 后加 *。
真正容易被忽略的是:即使你用了 CONCAT('%', #{keyword}, '%') 做 LIKE 模糊查,也**不等于** MATCH AGAINST 安全。两者防御逻辑完全不同——LIKE 能用 #{},MATCH 不能,别混用方案。

















