升级Hibernate至V6后，如何阻止JPA/HQL自动转换查询列名？

问题原因 #

Hibernate 6的HQL解析逻辑会默认将未加实体别名的id识别为实体主键的通用别名——无论你的主键属性实际命名为uuid还是其他，Hibernate都会把HQL中的id映射到主键对应的数据库列上。当你的实体中存在名为id的非主键属性时，就会出现这种属性映射冲突。

解决方案 #

1. 显式使用实体别名指定属性（推荐） #

修改HQL语句，给实体添加别名，通过别名明确引用id属性，避免Hibernate的默认解析逻辑：

from Schedule s where s.id = :scheduleId and s.sourceId = :sourceId

这样Hibernate会精准识别s.id是实体Schedule的非主键id属性，生成的SQL会正确使用表的id列作为过滤条件。

2. 全局禁用主键别名映射 #

如果有大量类似查询需要调整，可以通过全局配置关闭Hibernate对主键的id别名支持。在配置文件中添加：

# application.properties
hibernate.query.legacy_id_class_handling=true
hibernate.query.interpret_dollar_jpa_ql=false

⚠️ 注意：这个配置会影响所有依赖主键id别名的查询，需要全面测试现有业务逻辑后再启用。

3. 改用JPA Criteria API构建查询 #

如果不想修改HQL，也可以使用Criteria API构建查询，它会直接绑定实体属性，不会出现别名混淆：

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<Schedule> query = cb.createQuery(Schedule.class);
Root<Schedule> root = query.from(Schedule.class);

query.where(
    cb.equal(root.get("id"), scheduleId),
    cb.equal(root.get("sourceId"), sourceId)
);

List<Schedule> result = entityManager.createQuery(query).getResultList();

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