Spring Boot多数据源下实体类错误生成至所有数据库问题

这个问题我之前帮不少开发者解决过——本质是Spring Data JPA默认会把所有@Entity类纳入每个EntityManagerFactory的扫描范围，再加上全局的DDL配置被所有数据源继承，才导致了实体交叉生成到所有数据库的情况。咱们一步步来修复：

1. 为每个数据源的JPA配置明确限定扫描范围 #

每个数据源对应的JPA配置类（比如PrimaryDbConfig、PropertiesDbConfig）必须精准指定专属的实体包和仓库包，同时通过entityManagerFactoryRef和transactionManagerRef区分不同的实例，避免冲突。

举个PrimaryDbConfig的示例：

@Configuration
@EnableTransactionManagement
@EnableJpaRepositories(
        basePackages = "com.yourproject.primary.repository", // 仅扫描主数据源的仓库包
        entityManagerFactoryRef = "primaryEntityManagerFactory",
        transactionManagerRef = "primaryTransactionManager"
)
public class PrimaryDbConfig {

    @Primary
    @Bean(name = "primaryDataSource")
    @ConfigurationProperties(prefix = "spring.datasource.primary")
    public DataSource primaryDataSource() {
        return DataSourceBuilder.create().build();
    }

    @Primary
    @Bean(name = "primaryEntityManagerFactory")
    public LocalContainerEntityManagerFactoryBean primaryEntityManagerFactory(
            EntityManagerFactoryBuilder builder,
            @Qualifier("primaryDataSource") DataSource dataSource) {

        Map<String, Object> jpaProperties = new HashMap<>();
        jpaProperties.put("hibernate.ddl-auto", "update");
        jpaProperties.put("hibernate.generate-ddl", "true");

        return builder
                .dataSource(dataSource)
                .packages("com.yourproject.primary.entity") // 仅扫描主数据源的实体包
                .persistenceUnit("primaryPersistenceUnit") // 设置唯一的持久化单元名称
                .properties(jpaProperties)
                .build();
    }

    @Primary
    @Bean(name = "primaryTransactionManager")
    public PlatformTransactionManager primaryTransactionManager(
            @Qualifier("primaryEntityManagerFactory") EntityManagerFactory entityManagerFactory) {
        return new JpaTransactionManager(entityManagerFactory);
    }
}

对于PropertiesDbConfig，只需要替换对应的包路径（比如com.yourproject.properties.entity、com.yourproject.properties.repository），并设置不同的persistenceUnitName（比如propertiesPersistenceUnit）即可。

2. 移除全局DDL配置，改为每个数据源单独配置 #

把application.properties里的全局JPA配置：

spring.jpa.generate-ddl=true 
spring.jpa.hibernate.ddl-auto=update 

删掉，因为全局配置会被所有EntityManagerFactory继承，导致每个数据源都沿用相同的DDL策略。取而代之的是在每个数据源的JPA配置类里，通过jpaProperties单独设置（就像上面示例里那样），确保每个数据源的DDL行为独立可控。

3. 验证配置的独立性 #

启动应用后，你会发现每个数据库只会生成对应包下的实体表：主数据源的库只有Entity A，properties数据源的库只有Entity B，不会再出现交叉生成的情况。同时之前正常访问对应数据源表的功能也不会受影响。

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