Spring Boot如何复用模型与Repository配置多数据源？

刚好遇到过类似的场景，给你分享几个更优雅的解决方案，完美适配你的需求：

核心思路是通过repositoryBeanNamePrefix属性给不同数据源对应的Repository Bean设置唯一前缀，结合条件注解控制H2数据源配置仅在本地环境生效，既避免Bean冲突，又不用改动Repository结构。

具体实现步骤：

• 配置SQLServer数据源作为默认主数据源，扫描Repository包并设置前缀：

@Configuration
@EnableJpaRepositories(
    basePackages = "com.yourpackage.repository",
    entityManagerFactoryRef = "sqlServerEntityManagerFactory",
    transactionManagerRef = "sqlServerTransactionManager",
    repositoryBeanNamePrefix = "sqlServer" // 给Repository Bean加前缀
)
@Primary // 标记为默认数据源，注入时优先选择
public class SqlServerDataSourceConfig {
    // 配置SQLServer数据源、EntityManagerFactory、TransactionManager的代码
}

• 配置H2数据源，仅在dev环境激活，同样设置不同前缀：

@Configuration
@EnableJpaRepositories(
    basePackages = "com.yourpackage.repository",
    entityManagerFactoryRef = "h2EntityManagerFactory",
    transactionManagerRef = "h2TransactionManager",
    repositoryBeanNamePrefix = "h2" // 不同前缀避免Bean重名
)
@ConditionalOnProperty(name = "spring.profiles.active", havingValue = "dev") // 仅本地dev环境生效
public class H2DataSourceConfig {
    // 配置H2数据源、EntityManagerFactory、TransactionManager的代码
}

这样做的好处：

• 本地dev环境会生成两个Repository Bean（比如sqlServerUserRepo和h2UserRepo），注入时用@Qualifier("sqlServerUserRepo")或@Qualifier("h2UserRepo")区分即可同时操作两个数据源
• 远程prod环境下H2的配置自动不加载，仅保留SQLServer的Repository Bean，完全无冲突
• 不需要迁移Repository，也不需要上线时修改配置参数，靠profile自动控制

如果不想给Repository加前缀，可以选择仅让主数据源（SQLServer）自动扫描Repository包，而H2的Repository Bean在dev环境下手动创建，避免自动扫描导致的重复注册：

@Configuration
@ConditionalOnProfile("dev")
public class H2RepositoryConfig {
    @Autowired
    @Qualifier("h2EntityManagerFactory")
    private EntityManagerFactory h2EntityManagerFactory;

    // 手动创建H2对应的Repository实例
    @Bean
    public UserRepository h2UserRepository() {
        return new JpaRepositoryFactory(h2EntityManagerFactory.createEntityManager())
            .getRepository(UserRepository.class);
    }
}

SQLServer的配置保持正常的@EnableJpaRepositories扫描，标记为@Primary。这种方式也能实现本地双数据源、远程单数据源的需求，适合喜欢更手动控制Bean创建的场景。

• 不需要为不同环境拆分Repository包，复用同一套代码
• 不需要上线时修改配置参数，靠Spring的条件注解自动适配环境
• 本地环境可以同时操作两个数据源，满足你的特殊操作需求

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