Spring Boot 3.1.5升级3.2.0后Repository查询验证失败求助

核心原因 #

Spring Boot 3.2.0默认升级到了Hibernate ORM 6.2.x版本，该版本对JPQL的语义类型检查做了大幅强化，之前版本中允许的隐式类型转换、模糊字段引用等宽松处理，现在会触发严格的类型校验异常。

具体修复步骤 #

1. 修正JPQL中的实体别名引用 #

你的示例查询中，exists子查询里的EntityC未指定别名，直接使用字段名cId、dTypeId，Hibernate 6.2无法正确解析这些字段所属的实体类型，导致类型推断错误。修改后：

@Query(value = "SELECT new com.my.service.crud.ReferencedObject(p.id, p.name, r.name) FROM MyEntityA p join MyEntityB r on (p.aId = r.id) WHERE " +
               " p.aId = :projectId and exists (select ec.id from EntityC ec where ec.cId = p.id and ec.dTypeId = :uutId)")
List<ReferencedObject> findReferencesToUtilType(@Param("projectId") Long projectId, @Param("uutId") Long utilTypeId);

给EntityC添加别名ec，并通过别名引用字段，让Hibernate能准确推断字段类型。

2. 检查实体字段与参数的类型一致性 #

对于自动生成的查询（如findByIdAndOtherAttr(...)），逐一核对：

• 实体类中对应字段的类型（比如otherAttr是否为Long）
• Repository方法参数的类型是否和实体字段完全匹配
  如果存在类型不匹配（比如实体字段是Integer，参数是Long），要么调整方法参数类型，要么修改实体字段类型（需结合业务场景）。

3. 显式转换JPQL中的类型（必要时） #

如果确实需要跨类型比较，使用JPQL的CAST函数显式转换类型，确保两边类型一致：

// 示例：将参数转换为实体字段对应的类型
exists (select ec.id from EntityC ec where ec.cId = p.id and CAST(:uutId AS java.lang.Long) = ec.dTypeId)

注意JPQL支持的类型转换需符合Hibernate的规范，优先使用Java类型全限定名。

4. 排查Repository方法命名是否存在歧义 #

对于Spring Data自动生成的查询方法，避免使用模糊的命名导致Hibernate错误推断字段类型。比如如果实体中有多个同名字段（不同关联实体中），需明确指定字段所属的实体（通过_分隔，如findByIdAndEntityC_DTypeId(...)）。

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