Spring Boot 3.1.5集成Hibernate：setPhysicalNamingStrategy方法不存在启动失败

问题根源 #

1. Spring ORM适配Hibernate 6的API变更
   Spring Boot 3.1.x依赖的Spring Framework 6.x版本里，LocalSessionFactoryBean为了适配Hibernate 6的架构调整，直接移除了setPhysicalNamingStrategy这个setter方法。Hibernate 6本身对命名策略的配置逻辑做了重构，Spring ORM不再通过显式的setter传递命名策略实例，而是统一走Hibernate原生的配置属性通道。

2. 依赖版本冲突（概率低）
   虽然你用spring-boot-starter-data-jpa管理依赖，但如果项目里手动引入了其他版本的spring-orm或hibernate-core，可能会出现类版本不一致的问题——比如旧版LocalSessionFactoryBean被加载，但搭配了Hibernate 6依赖。不过你已经清理过.m2仓库，这种情况可能性很小，核心原因还是API变更。

其他解决办法 #

除了你已经在用的hibernate.physical_naming_strategy配置属性，还有两种更灵活的方案：

1. 直接给LocalSessionFactoryBean添加Hibernate属性 #

如果一定要通过代码配置LocalSessionFactoryBean，可以手动往它的Hibernate属性里加配置，支持直接注入实例：

@Bean
public LocalSessionFactoryBean sessionFactory(DataSource dataSource) {
    LocalSessionFactoryBean sessionFactory = new LocalSessionFactoryBean();
    sessionFactory.setDataSource(dataSource);
    sessionFactory.setPackagesToScan("com.yourpackage.entity");
    
    Properties hibernateProps = new Properties();
    // 直接注入自定义命名策略实例
    hibernateProps.put("hibernate.physical_naming_strategy", new YourCustomPhysicalNamingStrategy());
    // 其他Hibernate配置项，比如方言、show_sql等
    hibernateProps.put("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect");
    sessionFactory.setHibernateProperties(hibernateProps);
    
    return sessionFactory;
}

2. 使用HibernatePropertiesCustomizer（推荐） #

这是Spring Boot官方推荐的定制Hibernate配置的方式，不用手动创建LocalSessionFactoryBean，完全贴合自动配置生态：

@Component
public class HibernateNamingConfig implements HibernatePropertiesCustomizer {
    @Override
    public void customize(Map<String, Object> hibernateProperties) {
        hibernateProperties.put("hibernate.physical_naming_strategy", new YourCustomPhysicalNamingStrategy());
    }
}

这种方式不会破坏Spring Boot的自动配置逻辑，还能方便地添加其他Hibernate配置。

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