主Spring Boot应用启动报错：TestConfig重复注册Bean问题

核心问题原因 #

你的TestConfig使用了@SpringBootConfiguration，这会让主应用在组件扫描时误加载该配置类（即使它在src/test/java目录），进而重复注册JPA Repository Bean；开启allow-bean-definition-overriding=true后，TestConfig的@EnableJpaRepositories覆盖了主应用的JPA配置，但你只自定义了DataSource，未配置EntityManagerFactory，导致服务类找不到该Bean。

解决方案 #

1. 将TestConfig改为测试专用配置类 #

把@SpringBootConfiguration替换为@TestConfiguration，这是Spring Boot专门为测试场景设计的注解，只会在测试上下文加载，主应用完全不会识别：

@TestConfiguration
@EnableJpaRepositories(basePackages = {
        "com.sample.logistics"
})
@EntityScan(basePackages = {
        "com.sample.logistics"
})
@ActiveProfiles("test")
public class TestConfig {
    // 原有DataSource配置代码不变
}

2. 限制TestConfig仅在test Profile下加载 #

如果必须保留@Configuration，给TestConfig添加@Profile("test")注解，确保只有激活test Profile时才会加载该配置：

@Configuration
@Profile("test")
@EnableJpaRepositories(basePackages = {
        "com.sample.logistics"
})
@EntityScan(basePackages = {
        "com.sample.logistics"
})
@ActiveProfiles("test")
public class TestConfig {
    // 原有DataSource配置代码不变
}

3. 检查主应用组件扫描范围 #

确认主应用的@SpringBootApplication注解没有错误地包含src/test/java下的包。比如避免类似这样的配置：

// 错误示例：扫描范围包含了test目录的包
@SpringBootApplication(scanBasePackages = "com.sample")

确保主应用只扫描src/main/java下的业务包，或者直接使用默认扫描规则（主类所在包及其子包）。

额外优化：简化测试配置 #

结合@DataJpaTest和Testcontainers时，你可以不用自定义TestConfig：

• @DataJpaTest已经默认配置了JPA相关组件
• 只需在application-test.yml中配置Testcontainers的数据库连接信息，Spring Boot会自动创建DataSource和EntityManagerFactory

示例application-test.yml配置：

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/testdb
    username: testuser
    password: testpass
    driver-class-name: org.postgresql.Driver
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true

简化后的测试类：

@DataJpaTest  
@AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)  
@Testcontainers 
@ActiveProfiles("test")  
class OrderRepositoryTest {
    // 测试代码
}

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