SpringBoot Groovy+Spock测试中Mock Bean及Bean注入为空问题排查

问题背景 #

这是一个使用Groovy编写的Spock测试，测试代码如下：

@SpringBootTest
class SrMetricServiceAspectTest extends Specification {
@Autowired
@Qualifier("potentialSrCreation")
private SrCreationService service

@MockBean
SrMetricService srMetricService

@TestConfiguration
static class TestConfig {

    @Bean("potentialSrCreation")
    SrCreationService getSrCreationService() {
        // 返回带有必要依赖的PotentialSrCreation实例
        return new PotentialSrCreation()
    }
}
}

测试方法结构如下：

def "..." () {
   given: 
      ...
   when:
      ...
   then:
      ...

运行测试时，service实例为空，已尝试在测试文件内定义Bean，需排查配置或注入问题。

可能的原因及修复方式 #

1. 内部测试配置类未被Spring扫描加载 #

默认情况下，@TestConfiguration标记的内部类不会被@SpringBootTest自动扫描识别，需显式引入。

修复方案：
在测试类上添加@Import注解，指定加载内部配置类：

@SpringBootTest
@Import(SrMetricServiceAspectTest.TestConfig.class)
class SrMetricServiceAspectTest extends Specification {
    // ... 现有代码
}

2. PotentialSrCreation依赖缺失导致Bean初始化失败 #

如果PotentialSrCreation的构造函数需要其他依赖（如未被模拟或注入的Bean），Spring无法成功创建该Bean，最终导致service注入为空。

修复方案：

• 检查PotentialSrCreation的构造函数，为所有依赖提供测试环境下的实例（用@MockBean模拟或手动传入对象）：

@Bean("potentialSrCreation")
SrCreationService getSrCreationService() {
    // 示例：模拟PotentialSrCreation所需的DependencyA依赖
    DependencyA mockDependency = Mock(DependencyA)
    return new PotentialSrCreation(mockDependency)
}

3. 注解或类修饰符问题 #

• 确认@Qualifier指定的名称"potentialSrCreation"与Bean定义的名称完全一致，无拼写错误
• 内部TestConfig类必须保持static修饰（你的代码已满足此要求），否则Spring无法加载该配置类

4. @SpringBootTest扫描范围限制 #

若测试类与主应用类（带@SpringBootApplication的类）不在同一包或子包下，@SpringBootTest默认扫描范围可能无法覆盖测试配置类。

修复方案：
在@SpringBootTest中显式指定要加载的类：

@SpringBootTest(classes = [YourMainApplication.class, SrMetricServiceAspectTest.TestConfig.class])
class SrMetricServiceAspectTest extends Specification {
    // ... 现有代码
}

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