Spring项目迁移时Hibernate JPA命名策略配置异常问题

看起来你在从Spring Boot 1.5.9迁移到纯Spring项目时踩了Hibernate配置的坑，我来帮你梳理一下问题根源和解决办法：

首先，先明确那个警告的意思：hibernate.ejb.naming_strategy确实在Hibernate 5之后被废弃了，官方要求拆分为hibernate.implicit_naming_strategy和hibernate.physical_naming_strategy分别配置，你替换配置项的思路是对的，但报错的核心原因不是命名策略本身，而是你排除了Spring Boot的自动配置后，缺少了手动配置EntityManagerFactory所需的关键组件。

问题根源 #

Spring Boot的自动配置会帮你自动完成以下核心工作，但你排除了HibernateJpaAutoConfiguration等自动配置类后，这些都需要手动实现：

• 自动创建并配置数据源（你排除了DataSourceAutoConfiguration，所以数据源必须手动定义）
• 自动扫描实体类所在包
• 自动配置JPA厂商适配器（比如HibernateJpaVendorAdapter）
• 自动关联EntityManagerFactory和事务管理器

你之前的配置类只设置了Hibernate的属性Map，但缺少了上述这些必要配置，所以无论怎么调整命名策略，都会触发BeanCreationException。

完整解决方案 #

下面是一个可以直接参考的完整Hibernate JPA配置类，涵盖所有必要组件：

@Configuration
@EnableTransactionManagement // 开启事务管理
public class HibernateJpaConfig {

    // 1. 手动配置数据源（必须，因为排除了DataSourceAutoConfiguration）
    @Bean
    public DataSource dataSource() {
        DriverManagerDataSource dataSource = new DriverManagerDataSource();
        // 替换为你的数据库驱动、URL、用户名和密码
        dataSource.setDriverClassName("com.mysql.cj.jdbc.Driver");
        dataSource.setUrl("jdbc:mysql://localhost:3306/your_database_name");
        dataSource.setUsername("your_db_username");
        dataSource.setPassword("your_db_password");
        return dataSource;
    }

    // 2. 配置EntityManagerFactory，这是核心
    @Bean
    public LocalContainerEntityManagerFactoryBean entityManagerFactory() {
        LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
        
        // 关联数据源
        em.setDataSource(dataSource());
        // 设置实体类扫描路径，替换为你的实体所在包
        em.setPackagesToScan("com.yourcompany.yourproject.entity");

        // 配置Hibernate作为JPA厂商
        HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
        // 可选：设置数据库平台，比如MySQL
        vendorAdapter.setDatabasePlatform("org.hibernate.dialect.MySQL8Dialect");
        em.setJpaVendorAdapter(vendorAdapter);

        // 配置Hibernate属性，包括正确的命名策略
        Map<String, Object> properties = new HashMap<>();
        properties.put("hibernate.hbm2ddl.auto", "create-drop");
        // 使用官方推荐的隐式命名策略配置键
        properties.put("hibernate.implicit_naming_strategy", "org.hibernate.boot.model.naming.ImplicitNamingStrategyComponentPathImpl");
        // 可选：如果需要物理命名策略（比如处理表名大小写），可以添加
        // properties.put("hibernate.physical_naming_strategy", "org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy");

        em.setJpaPropertyMap(properties);

        return em;
    }

    // 3. 配置事务管理器
    @Bean
    public PlatformTransactionManager transactionManager(EntityManagerFactory emf) {
        JpaTransactionManager transactionManager = new JpaTransactionManager();
        transactionManager.setEntityManagerFactory(emf);
        return transactionManager;
    }
}

关键注意点 #

1. 数据源配置：必须确保数据源的驱动、URL、用户名密码正确，且对应的数据库驱动依赖已经添加到项目中
2. 实体扫描路径：setPackagesToScan必须指向你的实体类所在包，否则Hibernate无法识别实体，会导致映射失败
3. 命名策略类的可用性：确认ImplicitNamingStrategyComponentPathImpl在你的Hibernate版本中存在（Spring Boot 1.5.9对应的Hibernate版本是支持这个类的，如果你迁移后没改Hibernate版本，就没问题）
4. 异常排查：如果还是报错，一定要查看异常的完整堆栈信息，通常会明确指出具体原因（比如数据源连接失败、实体类注解错误等）

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