命名参数必须显式调用setParameter(),否则抛QueryParameterException导致查询失败;:name仅为占位符,不提供注入防护;参数名大小写敏感,拼错即报错;IN子句须用setParameterList(),表名/字段名/排序方向不可参数化,须白名单校验。

命名参数必须显式调用 setParameter(),否则查不到数据
Hibernate 6 不会在 createQuery() 阶段校验参数是否绑定,:name 只是语法占位符,不是安全开关。漏掉 query.setParameter("name", value),运行时直接抛 QueryParameterException,查询返回空结果——这不是注入,但功能立刻失效。
- 参数名大小写敏感:HQL 写
:userName,却传setParameter("username", ...)→ 报错 - 拼错字段名(如
:user_namevs"user_name")→ 同样报QueryParameterException - 误用已废弃的
setString("name", value)→ Hibernate 6 中类型推导弱,枚举、自定义类型可能序列化失败
IN 子句必须用 setParameterList(),不能传整个 List
把 List<long></long> 直接塞给 setParameter("ids", idList) 是典型错误。Hibernate 会把它当单个对象处理,生成类似 WHERE id = ?(? 对应整个 List),导致语法错误或全表扫描。
- 正确写法只有
setParameterList("ids", idList),Hibernate 自动展开为IN (?, ?, ?) - 空列表必须提前判断:
setParameterList()不接受空集合,会抛IllegalArgumentException - 别手动拼
"IN (" + String.join(",", ids) + ")"→ 注入风险 + 类型转换失败(比如字符串含单引号)
表名、字段名、排序方向无法参数化,必须白名单硬校验
HQL 和原生 SQL 都不支持 FROM :tableName 或 ORDER BY :sortField。任何字符串拼接都是非法且高危的。
- 动态表名/字段名 → 映射到
enum或用Set.of("user", "order", "product").contains(input)校验 - 排序方向(
ASC/DESC)→ 只允许字面量,禁止从请求参数直取 - 动态
GROUP BY字段、HAVING条件、分页OFFSET/LIMIT值 → 同样需白名单或范围限制(如limit≤ 1000)
优先用 Criteria API,而不是手写 HQL
Criteria API 是唯一能从源头杜绝 HQL 注入的方式:整个查询结构由 Java 方法链构建,没有字符串拼接,字段名是实体类属性名,拼错直接编译失败。
- 简单条件、关联查询、类型安全场景 →
CriteriaBuilder是首选 - 字段名写成
root.get("username"),不是数据库列名,受编译器检查 - 遇到
GROUP_CONCAT、深度子查询、数据库特有函数时,才回退到 HQL,但必须严格参数绑定
sortField=user.name,后端没拆解校验就拼进 HQL,哪怕值是白名单里的 user,.name 仍可能触发属性访问绕过。这类边界必须切开验证,不能只看一级字符串匹配。

















