Criteria API 天然防注入,因其不拼接SQL字符串而是用Java对象构建查询,通过PreparedStatement绑定参数,攻击字符串被当整体值处理,不解析为SQL语法。

Criteria API 为什么天然防注入
因为 Criteria API 不拼 SQL 字符串,而是用 Java 对象构建查询逻辑。整个过程不经过字符串解析,cb.equal(root.get("username"), username) 这类调用最终由 Hibernate 翻译成 PreparedStatement 绑定参数,底层交由 JDBC 预编译处理。攻击者输入 "admin' OR '1'='1" 会被当做一个完整字符串值传入,不会被解析成 SQL 语法片段。
必须用 CriteriaBuilder 构建完整查询对象
只写 session.createCriteria(User.class)(已过时)或漏掉 where() 条件、直接调用 list() 是无效的。真正起作用的是通过 CriteriaBuilder 和 CriteriaQuery 构建出带类型约束的查询结构。常见错误包括:
- 混用 HQL 字符串和 Criteria:比如先写
createQuery("FROM User WHERE ...")再试图“套”进 Criteria —— 不成立,两者互斥 - 用
Root.get("xxx")访问不存在的字段名:运行时报IllegalArgumentException,不是注入,但说明模型映射没对齐 - 忘记调用
session.createQuery(query):只建了CriteriaQuery对象,没触发执行,自然没绑定
动态条件要靠 Predicate 数组组合
实际业务中往往需要根据参数有无决定是否加 where 条件,不能硬编码所有字段。正确做法是收集 Predicate,再一次性传给 where():
List<pre class="brush:php;toolbar:false;" dicate> predicates = new ArrayList();
if (StringUtils.hasText(username)) {
predicates.add(cb.equal(root.get("username"), username));
}
if (status != null) {
predicates.add(cb.equal(root.get("status"), status));
}
query.where(predicates.toArray(new Predicate[0]));
注意:cb.and() 或 cb.or() 手动拼接多个条件时,必须确保每个子条件本身也是安全的 Predicate,不能在里面拼字符串。
别把 Criteria 当万能胶水
Criteria API 对复杂查询支持有限,比如子查询嵌套、自定义函数、动态表名/字段名等场景,它无法覆盖。此时若强行用 Criteria,反而可能绕过类型检查去拼字符串(例如 cb.function("CONCAT", ...) 后又手动塞变量),等于自废防御。遇到这类需求,应:
- 优先拆解为多个 Criteria 查询组合
- 必须用原生 SQL 时,改用
session.createNativeQuery(sql).setParameter("param", value),仍走参数绑定 - 绝对避免
"SELECT * FROM " + tableName这类动态表名拼接 —— 表名无法参数化,必须走白名单校验
最易被忽略的一点:Criteria 安全的前提是实体类字段与数据库列严格对应,且没有开放任意字段名反射查询的入口。一旦提供类似 findByField(String fieldName, Object value) 的泛型方法,又没对 fieldName 做枚举或白名单限制,就等于把字段名变成了可注入点。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











