Spring Boot 3+Hibernate 6遇SpringPhysicalNamingStrategy类找不到错误求助

核心原因 #

你遇到的问题本质是依赖版本不一致或配置被覆盖，即使更换了正确的命名策略类，依然因为类路径冲突、缓存残留或配置优先级问题导致构建失败。

排查与解决步骤 #

• 强制依赖版本统一
  Spring Boot 3.2.4已经内置适配的Hibernate 6.4.4版本，禁止手动指定Hibernate核心依赖版本。确保项目的Spring Boot父依赖（或依赖管理）严格锁定3.2.4：
  Maven示例：

  <parent>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-parent</artifactId>
      <version>3.2.4</version>
      <relativePath/>
  </parent>
  

  Gradle示例：

  plugins {
      id 'org.springframework.boot' version '3.2.4'
      id 'io.spring.dependency-management' version '1.1.4'
      id 'java'
  }
  

  只保留spring-boot-starter-data-jpa依赖，删除任何手动添加的hibernate-core、hibernate-entitymanager等依赖。

• 清理构建缓存
  旧的编译缓存或依赖缓存可能残留废弃类的引用，执行以下命令强制清理：

  • Maven：mvn clean install -U
  • Gradle：./gradlew clean build --refresh-dependencies

• 检查配置优先级与覆盖
  确认没有其他配置源覆盖你在application.yml中的设置：

  1. 查看项目中是否存在多环境配置文件（如application-dev.yml），其中可能重新定义了physical-strategy；
  2. 启动项目时添加--debug参数，在日志中搜索spring.jpa.hibernate.naming.physical-strategy，确认实际生效的配置值是否与你设置的一致；
  3. 检查是否有系统属性、环境变量或配置中心的配置覆盖了本地配置。

• 排查代码硬编码覆盖
  检查项目中是否存在自定义的JPA配置类，比如通过@Bean手动注册了PhysicalNamingStrategy：

  @Bean
  public PhysicalNamingStrategy physicalNamingStrategy() {
      // 这里如果返回旧的SpringPhysicalNamingStrategy，会覆盖配置文件设置
      return new SpringPhysicalNamingStrategy();
  }
  

  若存在此类代码，替换为Hibernate自带的实现：

  @Bean
  public PhysicalNamingStrategy physicalNamingStrategy() {
      return new CamelCaseToUnderscoresNamingStrategy();
  }
  

• 验证配置正确性
  确保你的application.yml配置路径正确，Spring Boot 3.x中JPA命名策略的配置层级无误：

  spring:
    jpa:
      hibernate:
        naming:
          physical-strategy: org.hibernate.boot.model.naming.CamelCaseToUnderscoresNamingStrategy
  

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