Spring Boot 2.7.x集成Hibernate 6.1.x及自定义SessionFactory方案咨询

可行性结论 #

完全可以在Spring Boot 2.7.x中集成Hibernate 6.1.x，但需要手动处理Spring ORM与Hibernate 6的适配问题——因为Spring Boot 2.7.x配套的Spring ORM 5.x原生仅支持Hibernate 3.x至5.x版本。

核心适配步骤 #

• 依赖调整：在pom.xml中排除Spring Boot默认的Hibernate 5依赖，显式引入Hibernate 6.1.x及Jakarta EE相关依赖（Hibernate 6基于Jakarta API，不再兼容旧Java EE）

  <!-- 排除Spring Boot默认的Hibernate依赖 -->
  <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-data-jpa</artifactId>
      <exclusions>
          <exclusion>
              <groupId>org.hibernate</groupId>
              <artifactId>hibernate-core</artifactId>
          </exclusion>
          <exclusion>
              <groupId>org.hibernate.javax.persistence</groupId>
              <artifactId>hibernate-jpa-2.1-api</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  
  <!-- 引入Hibernate 6.1.x核心包 -->
  <dependency>
      <groupId>org.hibernate.orm</groupId>
      <artifactId>hibernate-core</artifactId>
      <version>6.1.x</version>
  </dependency>
  
  <!-- 引入Jakarta Persistence API（Hibernate 6依赖） -->
  <dependency>
      <groupId>jakarta.persistence</groupId>
      <artifactId>jakarta.persistence-api</artifactId>
      <version>3.1.0</version>
  </dependency>
  

• 自定义SessionFactory与事务管理器：Spring ORM 5.x的org.springframework.orm.hibernate5.HibernateTransactionManager和LocalSessionFactoryBean无法兼容Hibernate 6，需手动构建适配组件：
  1. 手动构建SessionFactory：替代LocalSessionFactoryBean，直接使用Hibernate 6的API创建会话工厂

     @Bean
     public SessionFactory sessionFactory() {
         // 构建Hibernate服务注册表
         StandardServiceRegistry registry = new StandardServiceRegistryBuilder()
                 .applySettings(hibernateProperties())
                 .build();
         // 加载实体元数据
         Metadata metadata = new MetadataSources(registry)
                 .addAnnotatedClasses(YourEntity1.class, YourEntity2.class) // 替换为你的实体类
                 .getMetadataBuilder()
                 .build();
         // 创建SessionFactory
         return metadata.buildSessionFactory();
     }
     
     @Bean
     public Properties hibernateProperties() {
         Properties props = new Properties();
         props.put("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect"); // 替换为对应数据库方言
         props.put("hibernate.show_sql", "true");
         props.put("hibernate.hbm2ddl.auto", "update");
         // 添加其他Hibernate配置项
         return props;
     }
     

  2. 适配事务管理器：可以选择两种方式
     • 适配HibernateTransactionManager：直接注入自定义的Hibernate 6 SessionFactory（经测试可兼容基础事务场景）

       @Bean
       public PlatformTransactionManager transactionManager(SessionFactory sessionFactory) {
           HibernateTransactionManager txManager = new HibernateTransactionManager();
           txManager.setSessionFactory(sessionFactory);
           return txManager;
       }
       

     • 更推荐使用JpaTransactionManager：Hibernate 6完全兼容JPA 3.0，利用JPA的标准事务管理更稳定

       @Bean
       public PlatformTransactionManager transactionManager(EntityManagerFactory entityManagerFactory) {
           JpaTransactionManager txManager = new JpaTransactionManager();
           txManager.setEntityManagerFactory(entityManagerFactory);
           return txManager;
       }
       

• 代码适配Hibernate 6 API变更：Hibernate 6相对于4/5版本有大量API和语法变化，需逐一修改遗留代码：
  • 旧的@Type注解需替换为@JdbcType或@SqlType
  • HQL查询的语法、函数需适配Hibernate 6的解析规则
  • 主键生成策略、实体映射规则需调整（例如GenerationType.IDENTITY在部分数据库的行为变化）

注意事项 #

• Spring Boot 2.7.x与Hibernate 6的组合并非官方原生支持，部分自动配置可能失效，需手动补充
• 建议先在测试环境验证核心功能：事务提交回滚、CRUD操作、复杂查询执行等，确认无问题再迁移生产环境

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