Hibernate 6中setResultTransformer弃用及Spring Boot 3适配问题咨询

1. 替代setResultTransformer的方案 #

Hibernate 6彻底移除了ResultTransformer接口，推荐以下几种替代方式：

• JPQL构造函数投影：直接在查询中通过SELECT NEW语法实例化DTO，无需额外转换。

  String jpql = "SELECT NEW com.example.dto.UserDTO(u.id, u.username, u.createTime) FROM User u WHERE u.id = :id";
  UserDTO userDTO = entityManager.createQuery(jpql, UserDTO.class)
          .setParameter("id", 1L)
          .getSingleResult();
  

• 原生查询用@SqlResultSetMapping：如果是原生SQL查询，通过注解定义结果映射关系：

  @Entity
  @SqlResultSetMapping(
          name = "UserDTOMapping",
          classes = @ConstructorResult(
                  targetClass = UserDTO.class,
                  columns = {
                          @ColumnResult(name = "id", type = Long.class),
                          @ColumnResult(name = "username"),
                          @ColumnResult(name = "create_time", type = LocalDateTime.class)
                  }
          )
  )
  public class User { /* ... */ }
  
  // 查询时指定映射名称
  String sql = "SELECT id, username, create_time FROM user WHERE id = ?";
  UserDTO userDTO = entityManager.createNativeQuery(sql, "UserDTOMapping")
          .setParameter(1, 1L)
          .getSingleResult();
  

• 使用TupleTransformer/ResultListTransformer：针对复杂场景，可通过这两个新接口自定义转换逻辑：

  List<UserDTO> result = entityManager.createQuery("SELECT u.id, u.username FROM User u")
          .unwrap(org.hibernate.query.Query.class)
          .setTupleTransformer((tuple, aliases) -> new UserDTO((Long) tuple[0], (String) tuple[1]))
          .getResultList();
  

2. LocalDateTimeType无法导入的解决办法 #

Hibernate 6已完全内置Java 8+日期时间类型（java.time.LocalDateTime、LocalDate等）的支持，无需再导入org.hibernate.type.LocalDateTimeType这类自定义类型：

• 实体类中直接使用java.time.LocalDateTime，配合@Column注解即可：

  @Entity
  public class User {
      @Id
      private Long id;
      private String username;
      @Column(name = "create_time")
      private LocalDateTime createTime; // 无需额外类型注解
      // getter/setter
  }
  

• 若需自定义JDBC类型映射，可使用@JdbcTypeCode注解指定对应SQL类型：

  @Column(name = "create_time")
  @JdbcTypeCode(SqlTypes.TIMESTAMP)
  private LocalDateTime createTime;
  

推荐学习资料 #

• Hibernate 6官方迁移指南：重点关注"Result Transformers"和"Java 8 Date/Time Support"章节，详细说明了API变更和替代方案
• Spring Boot 3官方迁移文档：包含与Hibernate 6集成的注意事项
• Hibernate 6官方文档的"Querying"和"Mapping Types"章节：深入了解新的结果转换方式和类型映射机制

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