Spring项目部署Tomcat时EntityManager注入失败求助

这种NoSuchMethodError通常是依赖版本冲突或者类加载冲突导致的，你推测是Hibernate依赖问题的方向完全正确——哪怕你没手动引入某个问题依赖，也可能是其他依赖间接引入的，或是和Tomcat自带的库冲突了。下面是具体的排查和解决步骤：

1. 确认Spring与Hibernate的版本兼容性 #

不同版本的Spring和Hibernate有严格的匹配要求，比如：

• Spring Framework 5.3.x 搭配 Hibernate 5.4.x ~ 5.6.x
• Spring Framework 6.x 则需要 Hibernate 6.x 及以上版本
  如果用的是Spring Boot，建议直接使用spring-boot-starter-data-jpa或spring-boot-starter-hibernate，它会自动管理所有相关依赖的版本，避免手动引入导致的不兼容。

2. 排查传递依赖中的冲突 #

即使你没手动引入某个问题依赖，其他依赖（比如Spring Data JPA、第三方ORM工具等）可能会间接引入不同版本的Hibernate库。你可以通过Maven命令生成依赖树来排查：

mvn dependency:tree

在输出结果中搜索hibernate相关的依赖，看看是否存在多个版本的hibernate-core、hibernate-entitymanager等。如果发现冲突，在POM中用<exclusions>标签排除掉不兼容的版本，比如：

<dependency>
    <groupId>你的依赖组ID</groupId>
    <artifactId>你的依赖名称</artifactId>
    <version>xxx</version>
    <exclusions>
        <exclusion>
            <groupId>org.hibernate</groupId>
            <artifactId>hibernate-core</artifactId>
        </exclusion>
    </exclusions>
</dependency>

3. 检查Tomcat自带库的冲突 #

Tomcat的lib目录中可能自带了JPA或Hibernate相关的jar包，这些包的版本可能和你项目中的依赖不一致，导致类加载时出错。解决方法：

• 移除Tomcatlib目录中与Hibernate/JPA相关的jar（比如hibernate-*.jar、javax.persistence-api.jar等）
• 或者在项目的META-INF/context.xml中配置类加载优先级，让项目优先加载自身的依赖：

<Context antiResourceLocking="true" antiJARLocking="true">
    <!-- 其他配置内容 -->
</Context>

4. 验证EntityManagerFactory配置 #

确保你的Spring配置中正确初始化了EntityManagerFactory：

• 如果是XML配置：

<bean id="entityManagerFactory" class="org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean">
    <property name="dataSource" ref="dataSource"/>
    <property name="packagesToScan" value="com.yourpackage.entity"/>
    <property name="jpaVendorAdapter">
        <bean class="org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter"/>
    </property>
    <property name="jpaProperties">
        <props>
            <prop key="hibernate.dialect">org.hibernate.dialect.MySQL8Dialect</prop>
            <!-- 其他Hibernate配置参数 -->
        </props>
    </property>
</bean>

• 如果是注解配置：

@Configuration
@EnableJpaRepositories(basePackages = "com.yourpackage.repository")
@EntityScan(basePackages = "com.yourpackage.entity")
public class JpaConfig {
    @Bean
    public LocalContainerEntityManagerFactoryBean entityManagerFactory(DataSource dataSource) {
        LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
        em.setDataSource(dataSource);
        em.setPackagesToScan("com.yourpackage.entity");
        HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
        em.setJpaVendorAdapter(vendorAdapter);
        Properties properties = new Properties();
        properties.setProperty("hibernate.dialect", "org.hibernate.dialect.MySQL8Dialect");
        em.setJpaProperties(properties);
        return em;
    }
}

如果能提供你的POM依赖内容或者mvn dependency:tree的输出结果，我可以帮你更精准地定位冲突点。

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