如何修复JUnit测试中因Mockito注入失败导致的空指针异常-java教程-PHP中文网

如何修复JUnit测试中因Mockito注入失败导致的空指针异常

本文详解junit+mockito单元测试中常见的nullpointerexception根源——手动new实例覆盖了@injectmocks自动注入的被测对象，导致依赖未初始化；通过修正对象创建方式、正确配置注解与初始化流程，可彻底避免此类问题。

本文详解junit+mockito单元测试中常见的nullpointerexception根源——手动new实例覆盖了@injectmocks自动注入的被测对象，导致依赖未初始化；通过修正对象创建方式、正确配置注解与初始化流程，可彻底避免此类问题。

在使用 Mockito 进行 Spring Boot 单元测试时，NullPointerException（NPE）是最常见却极易被忽视的问题之一。从你提供的代码和堆栈跟踪可以看出：异常发生在 RunSummaryServiceImpl.processCustomerRunSummary() 的第 74 行，即调用 runSummaryRepository.findByCustomerIdAndSolutionNumberAndDownloadDatetime(...) 时抛出——说明该 Repository 依赖为 null，根本原因并非 Mockito 配置错误，而是测试逻辑本身破坏了依赖注入机制。

? 根本原因：重复创建实例，绕过依赖注入

关键问题出现在测试方法内部：

@Test
public void TestprocessCustomerRunSummaries() {
    final RunSummaryServiceImpl runSummaryServiceImpl = new RunSummaryServiceImpl(); // ❌ 错误！
    // ...
    runSummaryServiceImpl.processCustomerRunSummaries(runs); // 使用的是无依赖的裸对象 → NPE
}

尽管你在类级别声明并标注了：

@InjectMocks
RunSummaryServiceImpl runSummaryServiceImpl; // ✅ 正确声明（但被下方 new 覆盖！）

但在测试方法中又执行了 new RunSummaryServiceImpl()，这会创建一个完全独立、未经 Mockito 注入任何 mock 依赖的原始实例。此时 runSummaryRepository 和 fileRepository 均为 null（Java 默认值），调用其方法必然触发 NPE。

✅ 正确做法：复用已注入的被测对象

只需删除 new 语句，直接使用类成员变量 runSummaryServiceImpl 即可：

@Test
public void testProcessCustomerRunSummaries() { // 方法名建议使用驼峰小写 + test 前缀
    Collection<runsummary> runs = List.of(
        new RunSummary("customer1", 1, Timestamp.valueOf("2023-05-30 10:00:00")),
        new RunSummary("customer2", 2, Timestamp.valueOf("2023-05-30 11:00:00")),
        new RunSummary("customer3", 3, Timestamp.valueOf("2023-05-30 12:00:00"))
    );

    // ✅ 直接调用已注入依赖的实例
    runSummaryServiceImpl.processCustomerRunSummaries(runs);
}</runsummary>

⚠️ 注意：@InjectMocks 仅对当前测试类的成员变量生效，且要求该变量未被重新赋值。一旦执行 = new ...，就切断了 Mockito 的管理链。

?️ 补充最佳实践配置（适配现代 JUnit 5）

你当前使用 @Before + MockitoAnnotations.initMocks(this) 是 JUnit 4 风格，已过时。推荐升级为 JUnit 5 + MockitoExtension：

import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;

@ExtendWith(MockitoExtension.class) // 替代旧版 initMocks()
class RunSummaryServiceImplTest {

    @Mock
    private RunSummaryRepository runSummaryRepository;

    @Mock
    private FileRepository fileRepository;

    @InjectMocks
    private RunSummaryServiceImpl runSummaryServiceImpl; // 不再需要 @Spy 或 @SpringBootTest！

    @Test
    void testProcessCustomerRunSummaries() {
        // 准备测试数据
        Collection<runsummary> runs = List.of(
            new RunSummary("custA", 1, Timestamp.valueOf("2023-05-30 10:00:00"))
        );

        // ✅ 直接调用，无需 new
        runSummaryServiceImpl.processCustomerRunSummaries(runs);

        // 可选：验证 repository 是否被调用（即使方法是 void）
        verify(runSummaryRepository).findByCustomerIdAndSolutionNumberAndDownloadDatetime(
            "custA", 1, Timestamp.valueOf("2023-05-30 10:00:00")
        );
    }
}</runsummary>

✅ 优势：