SpringBoot 3多数据源升级后JPA实体未被发现问题求助

一、核心变更背景 #

Spring Boot 3 基于Spring Framework 6，JPA实体扫描逻辑从原有的packagesToScan驱动模式，切换为依赖ManagedTypes API的机制，新增的PersistenceManagedTypesScanner负责实体类的识别与加载。自定义多数据源场景下，原Spring Boot 2的配置逻辑不再自动适配新的扫描机制，导致PersistenceUnitInfo中Managed classes names为空。

二、修复方案：调整自定义数据源配置 #

针对LocalContainerEntityManagerFactoryBean的配置，需显式绑定ManagedTypes替代原有的packagesToScan配置，示例如下：

修改后的配置代码 #

@Bean
public LocalContainerEntityManagerFactoryBean entityManagerFactoryPrimary(
        DataSource primaryDataSource,
        JpaProperties jpaProperties,
        ResourceLoader resourceLoader) {
    LocalContainerEntityManagerFactoryBean em = new LocalContainerEntityManagerFactoryBean();
    em.setDataSource(primaryDataSource);
    
    // 显式构建ManagedTypes，指定实体包路径
    ManagedTypes managedTypes = ManagedTypesBuilder.fromPackages("com.yourcompany.entity.primary")
                                                   .withResourceLoader(resourceLoader)
                                                   .build();
    em.setManagedTypes(managedTypes);
    
    // 保留原有JPA供应商与属性配置逻辑
    HibernateJpaVendorAdapter vendorAdapter = new HibernateJpaVendorAdapter();
    em.setJpaVendorAdapter(vendorAdapter);
    em.setJpaProperties(jpaProperties.getProperties());
    
    return em;
}

关键注意点 #

1. 注解包迁移：所有实体类的@Entity、@Id、@Table等注解必须替换为jakarta.persistence.*包下的类，Spring Boot 3的扫描器不再识别javax.persistence.*包的注解。
2. 多数据源隔离：每个数据源对应的LocalContainerEntityManagerFactoryBean需单独配置对应的实体包路径，避免交叉扫描。

三、排查方向 #

1. 注解包验证：检查实体类的注解导入语句，确认无遗留的javax.persistence引用。
2. ManagedTypes有效性校验：在配置中添加断点或日志，查看ManagedTypes.getManagedClassNames()返回值，确认包含目标实体类名，排查包路径拼写、大小写错误。
3. 自动配置冲突排查：自定义多数据源时，排除Spring Boot自动JPA配置类，避免扫描逻辑冲突：

   @SpringBootApplication(exclude = {DataSourceAutoConfiguration.class, HibernateJpaAutoConfiguration.class})
   

4. 类加载器检查：若实体类通过自定义类加载器加载，需确保PersistenceManagedTypesScanner使用的类加载器能访问到实体类。
5. 自定义处理器冲突：若项目中存在PersistenceUnitPostProcessor实现，需调整其逻辑适配ManagedTypes机制，避免覆盖扫描结果。

四、POM依赖检查 #

确认Spring Boot 3相关依赖配置正确，示例：

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

<dependencies>
    <dependency>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-data-jpa</artifactId>
    </dependency>
    <!-- MySQL驱动（Spring Boot 3推荐） -->
    <dependency>
        <groupId>com.mysql</groupId>
        <artifactId>mysql-connector-j</artifactId>
        <scope>runtime</scope>
    </dependency>
    <!-- 其他自定义数据源依赖 -->
</dependencies>

注意MySQL驱动artifactId已从mysql-connector-java变更为mysql-connector-j。

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