SpringBoot3+Hibernate6迁移后JdbcTypeRecommendationException问题求助

一、解决org.hibernate.type.descriptor.java.spi.JdbcTypeRecommendationException异常 #

该问题源于Hibernate 6（SpringBoot 3.x默认依赖）对类型映射的校验更严格，当原生查询/视图映射的字段与Java对象属性类型无法自动匹配时触发，可按以下方式处理：

• 显式指定类型映射：在@SqlResultSetMapping的@ColumnResult中明确标注javaType或jdbcType，消除类型推断歧义。示例：

  @SqlResultSetMapping(
      name = "TestClass2Mapping",
      classes = @ConstructorResult(
          targetClass = TestClass2.class,
          columns = {
              @ColumnResult(name = "id", javaType = Long.class),
              @ColumnResult(name = "name", javaType = String.class),
              // 其余字段逐一指定对应类型
          }
      )
  )
  

• 校验类型兼容性：确认PostgreSQL视图返回的字段类型（如numeric、varchar）与Java对象属性类型（如Long、String）完全匹配，避免隐式转换导致的类型推断失败。
• 适配特殊类型：若使用JSON等特殊类型，需引入对应Hibernate类型模块（如hibernate-types-60），并在属性上通过@Type注解指定类型。

二、解决org.hibernate.HibernateException: Could not resolve specified result-set mapping name异常 #

该问题多因@SqlResultSetMapping定义位置或扫描规则不符合Hibernate要求，可按以下步骤排查：

• 将映射定义在实体类上：Hibernate仅扫描标注@Entity的类上的@SqlResultSetMapping，若TestClass2不是实体类，可给它添加@Entity+@Immutable注解（适配视图场景），或把映射定义到任意已存在的实体类上。示例：

  @Entity
  @Immutable
  @SqlResultSetMapping(name = "TestClass2Mapping", ...)
  public class TestClass2 {
      // 属性与构造方法
  }
  

• 核对映射名称：调用原生查询时指定的TestClass2Mapping必须与@SqlResultSetMapping的name属性完全一致，注意大小写敏感。
• 确认实体扫描范围：确保TestClass2所在包被SpringBoot实体扫描覆盖，可在启动类添加@EntityScan(basePackages = "com.your.package")指定扫描路径。

三、额外注意事项 #

• 正确创建原生查询：调用时需使用entityManager.createNativeQuery(sql, "TestClass2Mapping")，而非直接传入实体类（后者仅适用于标准实体映射）。
• 保持依赖版本一致：确保pom.xml中Hibernate版本与SpringBoot 3.1.3默认依赖的Hibernate 6.2.7.Final一致，避免版本冲突。

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