测试类中@ContextConfiguration与@Import注解的差异及适用场景

你在测试中发现使用@Import和@ContextConfiguration(classes)的两段代码执行效果一致，但二者的定位和适用场景有本质区别：

你的测试代码 #

代码片段1（使用@Import）

@ExtendWith(SpringExtension.class)
@Import({SpringService.class,SpringService2.class})
public class Snippet1 {

    @Autowired
    SpringService springService;

    @Autowired
    SpringService2 springService2;

    @Test
    public void test() {
        Assertions.assertNotNull(springService);
        Assertions.assertNotNull(springService2);
    }
}

代码片段2（使用@ContextConfiguration）

@ExtendWith(SpringExtension.class)
@ContextConfiguration(classes = {SpringService.class,SpringService2.class})
public class Snippet2 {

    @Autowired
    SpringService springService;

    @Autowired
    SpringService2 springService2;

    @Test
    public void test() {
        Assertions.assertNotNull(springService);
        Assertions.assertNotNull(springService2);
    }
}

核心定位差异 #

• @Import：属于Spring核心容器的通用注解，作用是向Spring容器导入并注册Bean（可以是普通组件类、配置类、ImportSelector实现类等），可用于任意Spring环境（业务代码、测试代码都适用）。
• @ContextConfiguration：是Spring Test测试框架的专属注解，作用是指定测试类的Spring应用上下文配置，仅在测试场景生效，支持配置类、XML文件、自定义上下文加载器等多种配置方式。

适用场景区分 #

优先用@Import的场景 #

1. 业务代码中的配置组合：在@Configuration标注的配置类中，通过@Import导入其他配置类或第三方组件，实现配置的模块化拆分，比如：

   @Configuration
   @Import({RedisConfig.class, MqConfig.class})
   public class AppMainConfig {}
   

2. 测试场景补充Bean：如果测试类已经通过@ContextConfiguration指定了主配置，但需要额外注册个别Bean，无需修改原配置类，直接在测试类上加@Import补充。
3. 动态注册Bean：配合ImportSelector或ImportBeanDefinitionRegistrar实现动态批量注册Bean，这是@ContextConfiguration不具备的能力。

优先用@ContextConfiguration的场景 #

1. 测试类指定完整上下文：当测试需要加载完整的应用上下文（比如包含数据库、MVC、事务等组件），通过classes属性指定主配置类，或者通过locations指定XML配置文件，这是Spring集成测试的标准用法。
2. 自定义测试上下文行为：通过loader属性指定自定义的ApplicationContextLoader，实现特殊环境的上下文加载（比如加载Mock环境、特定环境变量的上下文）。
3. 测试上下文复用：配合@TestInstance、@DirtiesContext等测试注解，更精细地控制测试上下文的生命周期，这是@Import无法做到的测试专属能力。

为什么你的测试效果一致？ #

在你的简单测试场景中，@Import直接把指定的组件类注册到测试上下文，而@ContextConfiguration(classes)会将指定的类视为配置类（即使是普通组件类，Spring Test也会自动注册其为Bean），所以最终容器里的Bean一致。但这只是极小的重合场景，二者的定位和功能范围差异很大。

内容的提问来源于stack exchange，提问作者work-in-progress