为SpringBootTest添加配置类致组件扫描失效，需替换Mongo为Fongo Mock

我之前也踩过这个坑——为了用Fongo Mock替换真实Mongo连接而添加自定义配置类后，经常会不小心打乱Spring Boot默认的组件扫描逻辑，导致Service、Controller这些业务组件加载失败。下面分享几个亲测有效的解决方案：

方案一：让配置类只专注于Mongo替换，别碰组件扫描 #

很多时候组件扫描失效，是因为自定义的Fongo配置类额外加了@ComponentScan注解，而且没指定正确的扫描范围，反而覆盖了Spring Boot默认的扫描逻辑。

正确的做法是：你的Fongo配置类只负责替换Mongo相关的Bean，不要画蛇添足加@ComponentScan。比如：

@Configuration
public class FongoTestConfig {
    @Bean
    public MongoClient mongoClient() {
        // 初始化Fongo实例
        return new Fongo("mock-mongo-instance").getMongo();
    }

    // 如果项目用到MongoTemplate，也需要替换成Fongo版本
    @Bean
    public MongoTemplate mongoTemplate() {
        return new MongoTemplate(mongoClient(), "test-db");
    }
}

如果确实需要在配置类里加@ComponentScan，一定要明确指定你业务代码所在的包，确保所有需要的组件都能被扫描到：

@Configuration
@ComponentScan(basePackages = {"com.yourproject.controller", "com.yourproject.service"})
public class FongoTestConfig {
    // Mongo相关Bean配置...
}

方案二：在测试类里明确指定要加载的配置和主启动类 #

直接在@SpringBootTest注解里同时指定项目的主启动类和Fongo配置类，这样Spring会同时加载主启动类的默认组件扫描逻辑，以及自定义的Fongo配置：

@SpringBootTest(classes = {YourApplicationMainClass.class, FongoTestConfig.class})
@RunWith(SpringRunner.class)
public class ControllerTest {
    @Autowired
    private WebApplicationContext wac;
    @Autowired
    private ObjectMapper objectMapper;
    @MockBean
    private MyService service;
    private MockMvc mockMvc;

    @Before
    public void setup() {
        this.mockMvc = MockMvcBuilders.webAppContextSetup(this.wac).build();
    }

    @Test
    public void performTest() throws Exception {
        // 测试逻辑...
    }
}

这里的YourApplicationMainClass.class是你Spring Boot项目的主启动类，它自带了默认的组件扫描范围，搭配Fongo配置类就能两全其美。

方案三：用Profile隔离测试与生产配置（最优雅的方式） #

给Fongo配置类打上@Profile("test")注解，这样只有在测试环境下才会加载这个配置，完全不会影响生产环境，同时也不会破坏默认的组件扫描：

1. 编写带Profile的Fongo配置：

@Configuration
@Profile("test")
public class FongoTestConfig {
    @Bean
    public MongoClient mongoClient() {
        return new Fongo("mock-mongo").getMongo();
    }

    @Bean
    public MongoTemplate mongoTemplate() {
        return new MongoTemplate(mongoClient(), "test-db");
    }
}

2. 在测试类上激活test Profile：

@SpringBootTest
@RunWith(SpringRunner.class)
@ActiveProfiles("test")
public class ControllerTest {
    // 你的测试代码...
}

这种方式下，Spring Boot会自动加载主启动类的组件扫描逻辑，同时加载test Profile下的Fongo配置，完美避免冲突。

额外提醒 #

• 不要在@MockBean和Fongo配置类中重复定义同一个Bean，否则会触发Bean定义冲突
• 如果你的MyService依赖Mongo相关Bean（比如MongoTemplate），一定要确保Fongo配置类提供了对应的Mock版本，否则Service会无法注入

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