如何在 JUnit 5 和 Mockito 中验证局部变量对象的方法调用-java教程-PHP中文网

如何在 JUnit 5 和 Mockito 中验证局部变量对象的方法调用

本文介绍两种无需 powermock 即可验证服务方法中对局部变量（如数据库查出的 user 实例）调用 setter 的测试方案：一是通过对象 getter 断言状态变更，二是使用 mockito spy 直接验证 setter 被调用。

本文介绍两种无需 powermock 即可验证服务方法中对局部变量（如数据库查出的 user 实例）调用 setter 的测试方案：一是通过对象 getter 断言状态变更，二是使用 mockito spy 直接验证 setter 被调用。

在基于 Spring Boot 的业务服务中，常出现类似 changeUserPassword 这样的方法：它从数据库查询用户实体（如 User user = userRepository.findByEmail(...).get()），并在同一方法作用域内直接调用该局部变量的 setter（如 user.setPassword(...)）。由于该对象未被注入、未被返回、也未作为参数传递给其他 mock 对象，传统 Mockito.verify() 无法对其方法调用进行断言——因为 verify() 只适用于被显式 mock 或 spy 的对象。

但好消息是：只要该对象实例在测试中可被持有，我们就能验证其状态或行为变化。核心逻辑在于——JPA/Hibernate 返回的实体、或普通 new User() 创建的对象，在测试中与被测方法内部操作的是同一个 Java 对象引用（即堆内存中的同一地址）。因此，方法执行后，该对象的状态变更（如密码字段更新）完全可观测。

✅ 方案一：通过 getter 断言状态变更（推荐，简洁可靠）

若 User 类提供了 getPassword() 方法，这是最直观、最符合测试原则的方式——验证“结果”而非“过程”。测试关注的是“密码是否已被正确更新”，而非“setPassword() 是否被调用”。

@Test
void changeUserPassword_updatesPasswordViaGetter() {
    // Arrange
    String email = "user@example.com";
    String newPassword = "newSecurePass123";
    User user = new User(); // 真实实例，非 mock
    user.setPassword("oldHashedPass"); // 初始密码（哈希值）

    when(userRepository.findByEmail(email)).thenReturn(Optional.of(user));
    when(passwordEncoder.matches("oldPlainPass", "oldHashedPass")).thenReturn(true);
    when(passwordEncoder.encode(newPassword)).thenReturn("newHashedPass");
    when(jwtUtil.extractUsername(anyString())).thenReturn(email);
    when(jwtUtil.generateToken(any(User.class))).thenReturn("mock-jwt-token");

    // Act
    testedService.changeUserPassword(
        ChangeUserPasswordDto.builder()
            .password("oldPlainPass")
            .newPassword(newPassword)
            .newPasswordConfirmation(newPassword)
            .build(),
        "mock-jwt-token"
    );

    // Assert: 直接检查对象状态
    assertEquals("newHashedPass", user.getPassword());
}

✅ 优势：不依赖反射或字节码增强；符合“测试行为契约”的理念；可读性强；兼容所有 JDK 版本。
⚠️ 注意：需确保 User 类的 getPassword() 返回的是实际存储字段（非计算值），且测试中未重写该方法。

✅ 方案二：使用 `spy()` 验证 setter 调用（适用于无 getter 场景）

当 User 类出于安全考虑未暴露 getPassword()（如仅允许通过 matches() 校验），或你明确需要验证“setPassword() 是否被精确调用一次”，可对返回的 User 实例使用 spy()：

@Test
void changeUserPassword_verifiesSetPasswordCall() {
    // Arrange
    String email = "user@example.com";
    String newPassword = "newSecurePass123";
    User user = new User();
    User spiedUser = spy(user); // 对真实对象做部分模拟

    when(userRepository.findByEmail(email)).thenReturn(Optional.of(spiedUser));
    when(passwordEncoder.matches("oldPlainPass", anyString())).thenReturn(true);
    when(passwordEncoder.encode(newPassword)).thenReturn("newHashedPass");
    when(jwtUtil.extractUsername(anyString())).thenReturn(email);
    when(jwtUtil.generateToken(any(User.class))).thenReturn("mock-jwt-token");

    // Act
    testedService.changeUserPassword(
        ChangeUserPasswordDto.builder()
            .password("oldPlainPass")
            .newPassword(newPassword)
            .newPasswordConfirmation(newPassword)
            .build(),
        "mock-jwt-token"
    );

    // Assert: 验证方法调用
    verify(spiedUser).setPassword("newHashedPass");
}

✅ 优势：能精确捕获方法调用次数、参数及顺序；适合调试或验证副作用逻辑。
⚠️ 注意：spy() 会保留原始方法行为（如 setPassword() 仍会赋值），因此状态断言（如 assertEquals）依然有效；但避免对 final 方法或类使用 spy()（需启用 Mockito inline）。

? 不推荐方案：PowerMock / ByteBuddy 增强

尽管 PowerMock 曾提供 @PrepareForTest + expectPrivate() 等能力来拦截局部变量方法，但它已停止维护（最新版支持至 JDK 17，不兼容 JDK 21+），且引入复杂性、降低测试稳定性与可移植性。现代 Mockito（4.0+）配合 spy() 和状态断言，已能覆盖绝大多数真实场景。

总结

优先选择 getter 断言：测试应聚焦于“系统是否产生预期状态”，而非“代码是否按某路径执行”。
spy() 是有力补充：当需验证不可见副作用（如时间戳设置、状态标记）或无访问器时，spy() 安全、轻量、无侵入。
避免过度测试实现细节：setPassword() 被调用本身不是业务契约，密码被成功更新并持久化才是。因此，结合 userRepository.save() 的 verify() 与 user.getPassword() 断言，构成更完整的验收闭环。