Spring WebMvc测试中声明额外Primary Bean的解决方案——解决@AutoConfigureMockMvc与@Configuration冲突问题

你遇到的错误是因为直接在测试类上使用@Configuration会和@AutoConfigureMockMvc的自动配置逻辑冲突——Spring会把标注了@Configuration的测试类当作普通配置组件处理，这和MockMvc的自动初始化流程不兼容。下面是几种可行的解决方案，优先推荐符合Spring测试规范的方式：

方案一：使用@TestConfiguration定义内部静态配置类 #

这是最简洁且规范的方式，@TestConfiguration是Spring为测试场景专门设计的注解，不会触发组件扫描，也完全兼容@AutoConfigureMockMvc。

修改你的RolesControllerTest如下：

@Sql(scripts = "classpath:..", executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
@Sql(scripts = "classpath:..", executionPhase = Sql.ExecutionPhase.AFTER_TEST_METHOD)
@WithMockUser(username = "junit", authorities = {}, roles = {})
class RolesControllerTest extends AbstractMockMvcTest {
    private final Instant fixedInstant = Instant.from(OffsetDateTime.of(2021, 6, 2, 15, 54, 0, 0, ZoneOffset.ofHours(2)));

    // 定义内部静态测试配置类
    @TestConfiguration
    static class TestClockConfiguration {
        // 添加@Primary确保这个Bean优先于默认的systemClock被注入
        @Primary
        @Bean
        Clock fakeClock() {
            return Clock.fixed(fixedInstant, ZoneId.ofOffset("UTC", ZoneOffset.ofHours(2)));
        }
    }

    // 你的测试方法...
}

为什么这个方案可行？ #

• @TestConfiguration只会在当前测试上下文生效，不会被Spring组件扫描识别为全局配置，完美适配MockMvc的自动配置流程。
• 结合你原代码中默认systemClock的@ConditionalOnMissingBean，只要测试上下文存在ClockBean，默认系统时钟就不会被创建；加上@Primary只是让优先级逻辑更明确，避免潜在的多Bean冲突。

方案二：抽取独立测试配置类并通过@Import引入 #

如果需要在多个测试类中复用伪造时钟的配置，可以把测试配置抽成独立类，再通过@Import引入到测试类中：

// 独立的测试配置类
@TestConfiguration
public class FixedClockConfig {
    private final Instant fixedInstant;

    // 构造器注入固定时间，方便不同测试类传入不同时间
    public FixedClockConfig(Instant fixedInstant) {
        this.fixedInstant = fixedInstant;
    }

    @Primary
    @Bean
    Clock fakeClock() {
        return Clock.fixed(fixedInstant, ZoneId.ofOffset("UTC", ZoneOffset.ofHours(2)));
    }
}

然后在测试类中引入：

@Import(FixedClockConfig.class)
@Sql(scripts = "classpath:..", executionPhase = Sql.ExecutionPhase.BEFORE_TEST_METHOD)
@Sql(scripts = "classpath:..", executionPhase = Sql.ExecutionPhase.AFTER_TEST_METHOD)
@WithMockUser(username = "junit", authorities = {}, roles = {})
class RolesControllerTest extends AbstractMockMvcTest {
    private final Instant fixedInstant = Instant.from(OffsetDateTime.of(2021, 6, 2, 15, 54, 0, 0, ZoneOffset.ofHours(2)));

    // 构造器注入配置类
    public RolesControllerTest() {
        super();
    }

    // 你的测试方法...
}

注意事项 #

• 绝对不要在测试类本身上直接使用@Configuration，这是触发冲突的核心原因。
• 若无需复用配置，方案一的内部静态类是最优选择，代码紧凑且隔离性好。
• 确保所有依赖Clock的Bean都通过依赖注入获取时钟（如你示例中的MyBean），这样测试时才能正确替换为伪造时钟。

内容的提问来源于stack exchange，提问作者usr-local-ΕΨΗΕΛΩΝ