Spring 6迁移报错：SpringHibernateJpaPersistenceProvider未实现指定接口

错误信息如下：

Class org.springframework.orm.jpa.vendor.SpringHibernateJpaPersistenceProvider does not implement the requested interface jakarta.persistence.spi.PersistenceProvider
    at org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean.createNativeEntityManagerFactory(LocalContainerEntityManagerFactoryBean.java:376) ~[spring-orm-6.0.2.jar:6.0.2]
    at org.springframework.orm.jpa.AbstractEntityManagerFactoryBean.buildNativeEntityManagerFactory(AbstractEntityManagerFactoryBean.java:409) ~[spring-orm-6.0.2.jar:6.0.2]
    at org.springframework.orm.jpa.AbstractEntityManagerFactoryBean.afterPropertiesSet(AbstractEntityManagerFactoryBean.java:396) ~[spring-orm-6.0.2.jar:6.0.2]
    at org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean.afterPropertiesSet(LocalContainerEntityManagerFactoryBean.java:352) ~[spring-orm-6.0.2.jar:6.0.2]
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.invokeInitMethods(AbstractAutowireCapableBeanFactory.java:1797) ~[spring-beans-6.0.2.jar:6.0.2]
    at org.springframework.beans.factory.support.AbstractAutowireCapableBeanFactory.initializeBean(AbstractAutowireCapableBeanFactory.java:1747) ~[spring-beans-6.0.2.jar:6.0.2]
    ... 58 more

可以从以下几个方向排查：

• 检查javax.persistence与jakarta.persistence包共存情况：Spring 6完全基于Jakarta EE规范，若类路径中存在旧JEE的javax.persistence相关依赖（比如遗留的hibernate-core 5.x、旧版JPA API），会导致PersistenceProvider接口来自不同包，出现类不兼容问题。
• 验证Hibernate版本适配性：Spring 6要求搭配Hibernate 6.x及以上版本，Hibernate 5.x及以下实现的是javax.persistence.spi.PersistenceProvider，而非Jakarta版本，会导致SpringHibernateJpaPersistenceProvider间接实现旧接口，与容器要求的新接口不匹配。
• 排查依赖传递冲突：用依赖分析工具（如Maven的mvn dependency:tree、Gradle的./gradlew dependencies）检查是否有第三方依赖偷偷引入了旧版本的Hibernate、JPA API或Spring ORM，这些隐性依赖会混入类路径引发冲突。
• 检查类加载器隔离问题：若是Web应用，确认应用服务器（如Tomcat）是否自带了旧版本JPA相关类，导致应用加载的类与服务器提供的类冲突。可尝试在WEB-INF/lib下排除服务器JPA模块，或调整类加载顺序。
• 核对Spring JPA配置：确认配置中是否指定了正确的persistenceProviderClass，有没有误配置为旧版Hibernate实现类，或存在自定义PersistenceProvider相关Bean干扰默认逻辑。

内容的提问来源于stack exchange，提问作者Vojtěch