多Spring Boot测试类用@MockBean覆盖Bean时重复定义问题求解

问题原因 #

Spring Boot测试框架会对测试上下文进行缓存复用，当两个测试类使用相同的@SpringBootTest配置（包括指定的classes）且都定义了同一个@MockBean时，第一个测试类运行后上下文被缓存，第二个测试类启动时尝试再次添加同一个Bean的Mock，就会触发“Duplicate mock definition”错误。

解决方案 #

方案1：每个测试类运行后销毁上下文 #

在每个测试类上添加@DirtiesContext注解，指定测试类运行完成后销毁上下文，避免上下文复用导致的冲突：

@SpringBootTest(classes = { thConfiguration.class, CaffeineCacheConfiguration.class })
@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_EACH_TEST_CLASS)
public class FirstTestClass {
    @MockBean
    private AwsFireLogger awsFireLogger;

    // 测试代码...
}

@SpringBootTest(classes = { thConfiguration.class, CaffeineCacheConfiguration.class })
@DirtiesContext(classMode = DirtiesContext.ClassMode.AFTER_EACH_TEST_CLASS)
public class SecondTestClass {
    @MockBean
    private AwsFireLogger awsFireLogger;

    // 测试代码...
}

注意：该方案会增加测试执行时间，因为每个测试类都需要重新初始化上下文，适合测试用例不多的场景。

方案2：将@MockBean移到基类并正确继承 #

把@MockBean定义在抽象基类中，确保基类添加@SpringBootTest配置，子类直接继承即可，这样上下文会共享且只初始化一次Mock：

@SpringBootTest(classes = { thConfiguration.class, CaffeineCacheConfiguration.class })
public abstract class BaseIntegrationTest {
    // 使用protected修饰，让子类可以访问
    @MockBean
    protected AwsFireLogger awsFireLogger;
}

// 子类直接继承，无需重复定义@MockBean
public class FirstTestClass extends BaseIntegrationTest {
    // 直接使用awsFireLogger进行测试
}

public class SecondTestClass extends BaseIntegrationTest {
    // 直接使用awsFireLogger进行测试
}

排查之前基类注入失败的问题：

• 确保基类添加了完整的@SpringBootTest配置（指定classes）
• 基类中的@MockBean字段使用protected或public修饰，避免子类无法访问
• 子类不要重复定义同名的AwsFireLogger字段

方案3：自定义上下文缓存键 #

通过@ContextConfiguration指定唯一的缓存键，让两个测试类使用不同的上下文缓存：

@SpringBootTest(classes = { thConfiguration.class, CaffeineCacheConfiguration.class })
@ContextConfiguration(uniqueId = "first-test")
public class FirstTestClass {
    @MockBean
    private AwsFireLogger awsFireLogger;
}

@SpringBootTest(classes = { thConfiguration.class, CaffeineCacheConfiguration.class })
@ContextConfiguration(uniqueId = "second-test")
public class SecondTestClass {
    @MockBean
    private AwsFireLogger awsFireLogger;
}

这种方式会让两个测试类各自初始化独立的上下文，既避免了重复定义错误，又比@DirtiesContext更灵活（可以按需隔离上下文）。

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