如何在Spring Boot 3/Spring 6与Hibernate 6中配置事务管理？

在Spring Boot 3（基于Spring 6）和Hibernate 6环境下，原配置的等效实现如下，核心调整点针对API适配和注入方式优化：

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(
    basePackages = "com.somewhere.packages",
    entityManagerFactoryRef = "sessionFactory",
    transactionManagerRef = "hibernateTransactionManager"
)
public class TransactionConfig {

    @Bean
    public LocalSessionFactoryBean sessionFactory() {
        LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
        sessionFactory.setPackagesToScan("com.somewhere.packages.model");
        sessionFactory.setHibernateProperties(hibernateProperties());
        // 需确保CustomMetadataSource适配Hibernate 6的org.hibernate.boot.MetadataSources接口
        sessionFactory.setMetadataSources(new CustomMetadataSource());
        // 若需指定数据源，可添加setDataSource(dataSource())，需提前定义DataSource Bean
        return sessionFactory;
    }

    @Bean
    public PlatformTransactionManager hibernateTransactionManager(SessionFactory sessionFactory) {
        HibernateTransactionManager transactionManager = new HibernateTransactionManager();
        // Spring 6推荐直接注入SessionFactory，避免手动调用getObject()引发的初始化问题
        transactionManager.setSessionFactory(sessionFactory);
        return transactionManager;
    }

    // 适配Hibernate 6的属性配置，部分属性名或值有变更
    private Properties hibernateProperties() {
        Properties properties = new Properties();
        properties.put("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect");
        properties.put("hibernate.show_sql", "true");
        // 根据实际需求添加其他Hibernate 6配置属性
        return properties;
    }
}

关键调整说明 #

• 事务管理器注入优化：不再通过sessionFactory().getObject()手动获取SessionFactory实例，改为方法参数注入，由Spring自动处理Bean的初始化顺序，避免潜在的初始化异常。
• Hibernate属性适配：Hibernate 6调整了部分配置属性，例如方言类（如MySQL8Dialect替代旧版本的MySQL5Dialect），需同步更新hibernateProperties()中的配置项。
• MetadataSources适配：如果你的CustomMetadataSource基于Hibernate 5的API实现，需要修改为适配Hibernate 6的org.hibernate.boot.MetadataSources接口。
• 可选简化方案：若无需自定义MetadataSources这类高级配置，Spring Boot 3支持通过配置文件自动完成JPA和事务配置，无需编写Java配置类：

spring:
  jpa:
    packages-to-scan: com.somewhere.packages.model
    hibernate:
      ddl-auto: update
    properties:
      hibernate:
        dialect: org.hibernate.dialect.MySQL8Dialect
        show_sql: true
  datasource:
    url: jdbc:mysql://localhost:3306/your_db
    username: your_user
    password: your_password

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