JPA Hibernate数值变量绑定异常：与字符串变量绑定行为不一致

哈哈，这个问题我之前踩过坑！一开始也纳闷为啥字符串参数好好用占位符，数值类型就直接硬编码进去了，后来查了Hibernate的文档才搞明白原因。

为啥会出现这个情况？ #

这其实是Hibernate Criteria API的一个参数处理优化行为：当它识别到数值类型是基本类型（比如int）或者编译期常量时，会直接把值硬编码到SQL里，觉得这样能省点参数绑定的开销；但字符串类型默认会被当成动态参数，所以保留了占位符。虽然初衷是优化，但这种不一致的行为不仅会导致SQL无法复用，规范上也不推荐（毕竟万一数值参数是用户输入的，还是有潜在风险）。

几个靠谱的解决办法 #

1. 把基本类型换成包装类型

最简单的办法就是把你的int age改成Integer age——Hibernate对包装类型的参数会默认当成动态参数处理，不会硬编码：

// 把int换成Integer
Integer age = 25;
Predicate predicate = cb.equal(root.get("age"), age);

2. 显式声明参数（更稳妥的方式）

如果不想改变量类型，可以用CriteriaBuilder的parameter()方法显式告诉Hibernate这是一个需要绑定的参数，指定类型和名称：

int age = 25;
// 显式声明参数类型和名称
Predicate agePredicate = cb.equal(root.get("age"), cb.parameter(Integer.class, "empAge"));

// 构建完查询后记得设置参数
CriteriaQuery<Employee> query = cb.createQuery(Employee.class);
// ... 其他查询逻辑，比如select、from等
TypedQuery<Employee> typedQuery = entityManager.createQuery(query);
typedQuery.setParameter("empAge", age);

3. 全局配置强制所有字面量用占位符

如果希望整个项目的Criteria API都统一用占位符，直接在Hibernate配置里加个参数就行：

• 要是用application.properties（Spring Boot项目）：

hibernate.criteria.literal_handling_mode=BIND

• 传统的persistence.xml配置：

<property name="hibernate.criteria.literal_handling_mode" value="BIND"/>

这个配置会强制Hibernate把所有Criteria里的字面量（不管是数值、布尔还是啥）都用占位符绑定，彻底解决这个问题。

验证一下 #

用上面任意一种方法后，生成的SQL应该就变成这样了，所有参数都是占位符：

select * from (
 select emp0_.emp_id as emp_id1_10_0_, empdeta1_.emp_name as emp_name1_25_1_, empdeta1.emp_age as emp_age1_10_0
 where empdeta1.emp_name=? and empdeta1.emp_age=?
) where rownum <= ?

内容的提问来源于stack exchange，提问作者Anshuman