升级Java/Spring Boot后EntityManagerFactory自动注入失败求助

核心原因是Spring Boot 3.x完全切换到Jakarta EE规范，替代了原Java EE的javax包，你的多数据源配置类中存在javax与jakarta API混用或残留旧依赖导致类型不匹配，按以下步骤逐一排查修复：

1. 全量替换配置类的JPA API导入 #

检查所有多数据源配置类，把所有javax.persistence开头的导入替换为jakarta.persistence：

• 替换前：import javax.persistence.EntityManagerFactory;
• 替换后：import jakarta.persistence.EntityManagerFactory;

同时确保其他相关注解/类的导入也同步替换，比如：

• javax.persistence.PersistenceContext → jakarta.persistence.PersistenceContext
• javax.persistence.EntityManager → jakarta.persistence.EntityManager

2. 修正多数据源的Bean定义类型 #

确认配置类中LocalContainerEntityManagerFactoryBean的返回与注入类型一致：
示例正确的多数据源配置片段：

import jakarta.persistence.EntityManagerFactory;
import org.springframework.orm.jpa.LocalContainerEntityManagerFactoryBean;
import org.springframework.orm.jpa.vendor.HibernateJpaVendorAdapter;

// 主数据源配置
@Bean(name = "primaryEntityManagerFactory")
public LocalContainerEntityManagerFactoryBean primaryEntityManagerFactory(
        @Qualifier("primaryDataSource") DataSource dataSource) {
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    em.setDataSource(dataSource);
    em.setPackagesToScan("com.your.project.primary.entity");
    em.setPersistenceUnitName("primaryPU");

    HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
    em.setJpaVendorAdapter(vendorAdapter);
    return em;
}

// 注入时明确使用jakarta的EntityManagerFactory
@Autowired
@Qualifier("primaryEntityManagerFactory")
private EntityManagerFactory primaryEntityManagerFactory;

注意：LocalContainerEntityManagerFactoryBean本身是Spring提供的类（包路径不变），但它生成的EntityManagerFactory已经是Jakarta规范的实现，必须用jakarta.persistence.EntityManagerFactory接收。

3. 清理残留的javax依赖 #

检查项目依赖文件（Maven pom.xml / Gradle build.gradle）：

• 移除所有手动引入的javax.persistence-api依赖
• 排查第三方依赖是否传递引入了javax包，通过排除规则清理：
  Maven示例：

  <dependency>
      <groupId>第三方依赖groupId</groupId>
      <artifactId>第三方依赖artifactId</artifactId>
      <version>对应版本</version>
      <exclusions>
          <exclusion>
              <groupId>javax.persistence</groupId>
              <artifactId>javax.persistence-api</artifactId>
          </exclusion>
      </exclusions>
  </dependency>
  

• 确保使用Spring Boot 3.1.1父依赖管理的Hibernate版本（默认是Hibernate 6.x，完全支持Jakarta），不要手动引入Hibernate 5.x版本。

4. 验证配置文件的兼容性 #

确认application.yml/application.properties中的JPA配置适配Hibernate 6：

• 已完成的spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect是正确的，Hibernate 6中已移除版本号后缀的Dialect，统一使用PostgreSQLDialect
• 若有自定义JPA属性，避免使用Hibernate 5.x的旧属性（比如hibernate.jdbc.lob.non_contextual_creation在Hibernate 6中已默认开启，可移除）

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