Spring Boot双组件多数据源配置@Primary注解冲突问题求解

架构老林

2026-10-3

现有配置首先存在3处明显错误，需要先修正：

App2的Persistence配置类明显是复制的App1代码，@EnableJpaRepositories的basePackages、entityManagerFactoryRef、transactionManagerRef全配置成了App1的属性，会导致Repository扫描、持久化上下文完全混乱，必须改成App2自己的包路径和Bean名称。
App2的app2DataSource方法中调用了不存在的tmDataSourceProperties()，应该改为App2自己的app2DataSourceProperties()方法。
两份配置都只声明了DataSource Bean，缺少对应绑定的EntityManagerFactory、TransactionManager完整配置，JPA多数据源场景下这两个Bean是必须的。

核心@Primary冲突解决方案

你目前的配置思路是可行的，冲突的本质是App2作为独立应用需要@Primary覆盖默认数据源，作为依赖时不需要这个@Primary，用条件注解就能完美解决这个场景的需求，推荐以下最优方案：

方案：拆分App2的持久化配置，用条件注解控制@Primary是否生效

将App2的配置拆分为「基础公共配置」和「独立运行专属配置」两部分：

基础公共配置：不管是作为独立应用还是依赖都加载，仅注册App2运行必需的DataSource、EntityManagerFactory、TransactionManager，不带@Primary注解。
独立运行专属配置：仅当App2处于独立运行模式时才加载，负责将App2的数据源相关Bean设置为@Primary，满足独立运行时覆盖Spring默认数据源的要求。

修正后的App2配置示例：

1. 基础公共配置

@Configuration
@EnableJpaRepositories(
  basePackages = "com.ev.app2.repositories", // 替换为App2自身的Repository包路径
  entityManagerFactoryRef = "app2EntityManagerFactory",
  transactionManagerRef = "app2TransactionManager"
)
public class App2PersistenceBaseConfig {
    @Bean
    @ConfigurationProperties(prefix = "app.datasource.app2")
    public DataSourceProperties app2DataSourceProperties() {
        return new DataSourceProperties();
    }

    @Bean(name = "app2DataSource")
    @ConfigurationProperties(prefix = "app.datasource.app2")
    public DataSource app2DataSource() {
        return app2DataSourceProperties().initializeDataSourceBuilder()
          .type(BasicDataSource.class).build();
    }

    // 补充App2专属的EntityManagerFactory
    @Bean(name = "app2EntityManagerFactory")
    public LocalContainerEntityManagerFactoryBean app2EntityManagerFactory(
            EntityManagerFactoryBuilder builder,
            @Qualifier("app2DataSource") DataSource dataSource) {
        return builder
                .dataSource(dataSource)
                .packages("com.ev.app2.entity") // 替换为App2自身的实体类包路径
                .persistenceUnit("app2PersistenceUnit")
                .build();
    }

    // 补充App2专属的事务管理器
    @Bean(name = "app2TransactionManager")
    public PlatformTransactionManager app2TransactionManager(
            @Qualifier("app2EntityManagerFactory") LocalContainerEntityManagerFactoryBean app2EntityManagerFactory) {
        return new JpaTransactionManager(Objects.requireNonNull(app2EntityManagerFactory.getObject()));
    }
}

2. 独立运行专属配置

@Configuration
@ConditionalOnProperty(
  prefix = "app2.config", 
  name = "independent-mode", 
  havingValue = "true", 
  matchIfMissing = true // 默认开启，App2单独运行时自动生效
)
public class App2IndependentPersistenceConfig {
    // 独立运行时将App2数据源设为Primary，满足Spring默认数据源要求
    @Bean
    @Primary
    public DataSource primaryAppDataSource(@Qualifier("app2DataSource") DataSource app2DataSource) {
        return app2DataSource;
    }

    @Bean
    @Primary
    public LocalContainerEntityManagerFactoryBean primaryAppEntityManagerFactory(
            @Qualifier("app2EntityManagerFactory") LocalContainerEntityManagerFactoryBean app2EntityManagerFactory) {
        return app2EntityManagerFactory;
    }

    @Bean
    @Primary
    public PlatformTransactionManager primaryAppTransactionManager(
            @Qualifier("app2TransactionManager") PlatformTransactionManager app2TransactionManager) {
        return app2TransactionManager;
    }
}

3. App1引入App2后的适配

只需要在App1的application.properties中添加一行配置，关闭App2的独立运行模式即可，不会再加载带@Primary的配置，冲突完全解决：

app2.config.independent-mode=false

同时需要把App2的数据库配置也复制到App1的application.properties中（Spring Boot不会自动加载依赖Jar包中的application.properties配置）。

其他可选方案

如果不想改App2的配置，也可以选择以下两种方案：

方案2：所有注入DataSource的地方都明确加@Qualifier指定Bean名称，包括App1、App2的EntityManagerFactory、事务管理器配置，完全不需要@Primary注解，自然不会冲突。
方案3：App1启动类排除App2的持久化配置类，自己重新配置不带@Primary的App2数据源：@SpringBootApplication(exclude = App2PersistenceBaseConfig.class)。

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