Spring中测试@AutowiredService方法

各位小伙伴们，大家好呀！看看今天我又给各位带来了什么文章？本文标题是《Spring中如何正确测试@Autowired的Service类》，很明显是关于文章的文章哈哈哈，其中内容主要会涉及到等等，如果能帮到你，觉得很不错的话，欢迎各位多多点评和分享！

本文介绍在单元测试中为Spring Service类注入Mock依赖的正确方法，解决因@Autowired失效导致的空指针异常问题，重点讲解手动属性注入、构造器注入及推荐的测试实践。

在Spring应用中，@Autowired 依赖注入由Spring容器在运行时自动完成；但在纯JUnit + Mockito的单元测试中（未启动Spring上下文），该注解完全无效。因此，直接 new MyService() 创建实例后，其 @Autowired ExternalService externalService 字段仍为 null，调用时必然抛出 NullPointerException。

你当前的测试代码存在两个关键问题：

1. @Mock private ExternalService externalService = Mockito.mock(...) 是冗余写法（@Mock 已完成mock创建，无需再显式调用 Mockito.mock()）；
2. Mockito.spy(new MyService()) 创建的是被测对象的“间谍”，但并未将 externalService mock 注入到该实例中——字段仍为空。

✅ 正确做法一：手动字段注入（快速修复）

@ExtendWith(MockitoExtension.class)
class MyServiceTest {

    @Mock
    private ExternalService externalService; // 简洁声明即可

    private MyService myService;

    @BeforeEach
    void setUp() {
        myService = new MyService(); // 直接new实例
        myService.externalService = externalService; // 手动赋值，绕过@Autowired
    }

    @Test
    void methodToTest_Test() {
        // 使用 doReturn().when() 避免anyString()作为返回值（anyString()是匹配器，不能作返回值！）
        when(externalService.call(anyString())).thenReturn("mocked-response");

        String result = myService.methodToTest("test-arg");

        assertThat(result).isEqualTo("mocked-response");
        verify(externalService).call("test-arg");
    }
}

⚠️ 注意：thenReturn(anyString()) 是常见错误——anyString() 是参数匹配器（Matcher），不可用作返回值，应替换为具体字符串或 Mockito.any()（不推荐）；更安全的做法是返回确定值（如 "mocked-response"）。

✅ 推荐做法二：重构为构造器注入（最佳实践）

修改 MyService，优先使用构造器注入（符合Spring官方推荐与测试友好性）：

@Service
public class MyService {
    private final ExternalService externalService;

    // 构造器注入（Spring 4.3+ 支持无@Autowire注解）
    public MyService(ExternalService externalService) {
        this.externalService = externalService;
    }

    public String methodToTest(String myArg) {
        return externalService.call(myArg);
    }
}

测试代码立即变得简洁、安全且无需反射或字段赋值：

@ExtendWith(MockitoExtension.class)
class MyServiceTest {

    @Mock
    private ExternalService externalService;

    private MyService myService;

    @BeforeEach
    void setUp() {
        myService = new MyService(externalService); // 依赖通过构造器传入
    }

    @Test
    void methodToTest_Test() {
        when(externalService.call("test-arg")).thenReturn("success");

        String result = myService.methodToTest("test-arg");

        assertThat(result).isEqualTo("success");
        verify(externalService).call("test-arg");
    }
}

? 总结建议

• 避免字段注入测试：手动赋值 myService.externalService = mock 虽可行，但脆弱（依赖字段名、易因重构出错）、不可扩展；
• 拥抱构造器注入：提升可测试性、明确依赖关系、支持final字段保障不可变性；
• 慎用 @Spy：Mockito.spy() 适用于部分模拟场景，但对新实例无注入帮助，此处纯属冗余；
• 若必须保留字段注入，可考虑 ReflectionTestUtils.setField(myService, "externalService", externalService)，但仍是次优解。

遵循构造器注入原则，你的Service类将天然适配单元测试，彻底告别 NullPointerException 和手工注入的维护负担。

文中关于的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《Spring中测试@AutowiredService方法》文章吧，也可关注golang学习网公众号了解相关技术文章。