@SpringBootTest上下文加载失败 无法找到@Autowired MapStruct Mapper组件

核心问题定位 #

手动执行./gradlew api:bootRun启动正常、普通单元测试可运行，仅@SpringBootTest标注的集成测试报NoSuchBeanDefinitionException提示找不到ca.me.proj.api.mapper.base.IBaseMapper类型Bean，90%以上场景是测试环境构建配置或组件扫描范围问题，按以下顺序排查即可：

排查步骤1：补全Gradle测试环境的注解处理器配置 #

main源码集启动正常说明生产环境的MapStruct注解处理器配置生效，测试环境找不到Bean最常见原因是test源码集未配置对应注解处理器，测试编译阶段根本没有生成MapStruct的Mapper实现类。
在api子模块的build.gradle依赖配置中补充测试级别的注解处理器声明：

dependencies {
    // 原有生产环境MapStruct、Lombok配置保留
    implementation "org.mapstruct:mapstruct:${mapstructVersion}"
    annotationProcessor "org.mapstruct:mapstruct-processor:${mapstructVersion}"
    // 若项目同时使用Lombok，需保留lombok与mapstruct的绑定依赖避免处理器顺序冲突
    annotationProcessor "org.projectlombok:lombok-mapstruct-binding:${lombokMapstructBindingVersion}"
    compileOnly "org.projectlombok:lombok:${lombokVersion}"

    // 重点补充：测试编译阶段的注解处理器配置，绝大多数漏配该部分导致问题
    testAnnotationProcessor "org.mapstruct:mapstruct-processor:${mapstructVersion}"
    testAnnotationProcessor "org.projectlombok:lombok-mapstruct-binding:${lombokMapstructBindingVersion}"
    testCompileOnly "org.projectlombok:lombok:${lombokVersion}"
}

配置完成后执行./gradlew clean api:compileTestJava，检查路径api/build/generated/sources/annotationProcessor/java/test下是否生成了IBaseMapperImpl实现类，未生成则说明注解处理器配置仍有错误。

排查步骤2：校验集成测试的组件扫描范围 #

如果确认Mapper实现类已经生成但仍报错，检查集成测试类的包路径与扫描配置：

• SpringBoot默认以测试类所在包为根路径执行组件扫描，若测试类放置的包路径与SpringBoot启动类所在的根包ca.me.proj.api不一致，会出现扫描遗漏。优先将集成测试类挪到启动类同包或子包下。
• 若测试类路径无法调整，在测试类上显式声明扫描范围：

@SpringBootTest
@ComponentScan(basePackages = "ca.me.proj.api")
public class TargetIntegrationTest {
    // 测试逻辑
}

兜底校验：所有MapStruct的@Mapper注解必须配置componentModel = "spring"属性，即@Mapper(componentModel = "spring")，否则生成的实现类不会被Spring容器托管。由于手动启动正常，该问题概率极低。

排查步骤3：检查测试环境的配置排除规则 #

检查src/test/resources下的测试专属配置文件（application.yml、application-test.yml）以及测试类上关联的@TestConfiguration类，确认不存在以下配置：

• 自定义TypeExcludeFilter规则过滤了mapper包下的类
• 配置了Bean定义覆盖相关的拦截规则误拦截Mapper实现类
• 主动排除了MapStruct相关的组件扫描规则

排查步骤4：清理构建缓存重试验证 #

Gradle增量构建缓存、IDE编译缓存都可能导致旧的编译产物干扰结果，改完配置后优先用命令行执行全量清理后再跑测试，不要直接用IDE的运行按钮触发测试：

./gradlew clean
./gradlew api:test --tests "集成测试类全限定名"

命令行跑通后再执行IDE的缓存清理（IDEA可执行File -> Invalidate Caches），避免IDE本地缓存导致的异常。

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