如何构建精简Spring上下文测试带装饰器的MapStruct CardMapper

要实现只加载CardMapper及其装饰器，不加载整个应用上下文，核心是避免使用@SpringBootTest（它会默认触发全量上下文加载），转而使用Spring测试的基础注解搭配精准的配置类。以下是两种可靠实现方式：

方式一：手动注册Bean（最精准） #

通过自定义配置类手动创建并注册CardMapper和装饰器实例，完全控制上下文内容：

测试类 #

// 仅加载指定配置类，不触发全量Spring Boot自动配置
@ExtendWith(SpringExtension.class)
@ContextConfiguration(classes = CardMapperTestConfig.class)
class CardMapperTest {
    @Autowired
    CardMapper cardMapper;

    // 测试逻辑
    @Test
    void testMapping() {
        // 调用cardMapper进行测试
    }
}

测试配置类 #

利用MapStruct的MapperFactoryBean自动处理装饰器与委托的绑定，无需手动实例化实现类：

@Configuration
public class CardMapperTestConfig {

    @Bean
    public MapperFactoryBean<CardMapper> cardMapperFactoryBean() {
        // 创建MapStruct工厂Bean，指定Mapper接口
        MapperFactoryBean<CardMapper> factoryBean = new MapperFactoryBean<>(CardMapper.class);
        // 设置装饰器类，工厂会自动生成带装饰逻辑的代理实例
        factoryBean.setDecorator(CardMapperDecorator.class);
        return factoryBean;
    }
}

如果不想依赖MapperFactoryBean，也可以手动实例化MapStruct生成的实现类（默认类名为接口名+Impl）：

@Configuration
public class CardMapperTestConfig {

    // 注册原始Mapper实现作为委托
    @Bean
    public CardMapper cardMapperDelegate() {
        return new CardMapperImpl();
    }

    // 注册装饰器并注入委托
    @Bean
    public CardMapper cardMapper(CardMapper cardMapperDelegate) {
        return new CardMapperDecorator(cardMapperDelegate);
    }
}

方式二：精准组件扫描（适用于包内无多余Bean场景） #

如果CardMapper和CardMapperDecorator所在包内没有其他需要排除的Bean，可以用@ComponentScan指定精确的类而非整个包路径（注意：不要用文件系统路径，要用Java包名）：

测试配置类 #

@Configuration
@ComponentScan(
    // 指定要扫描的类，Spring会自动扫描这些类所在的包
    basePackageClasses = {CardMapper.class, CardMapperDecorator.class},
    // 排除其他不必要的配置类，避免加载额外上下文
    excludeFilters = @ComponentScan.Filter(type = FilterType.ANNOTATION, classes = Configuration.class)
)
public class CardMapperTestConfig {
}

测试类的注解和方式一一致，使用@ExtendWith(SpringExtension.class) + @ContextConfiguration。

为什么之前的方案失败？ #

你之前用@SpringBootTest(classes = ...)时，@ComponentScan写了文件路径（src/main/java/com/example/somepackage/mapper），这是错误的——basePackages需要的是Java包名（比如com.example.somepackage.mapper），而非文件系统路径。另外，@SpringBootTest即使指定了配置类，仍可能触发部分Spring Boot自动配置，不如用@ContextConfiguration更纯粹。

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