如何解决Java测试中的严格存根参数不匹配问题？

首先明确两个核心问题：

1. 业务代码的隐藏bug #

你的updatePerson方法没有返回构建后的Person对象，导致业务代码中updatedPerson实际为null，先修复这个问题：

private Person updatePerson(Person person) {
  // 补充return关键字返回构建好的对象
  return person.toBuilder()
        .setActive(true)
        .build();
}

2. 严格存根参数不匹配的根源 #

Mockito严格存根模式下，默认按对象引用匹配参数。你测试中手动构建的updatedPerson，和业务代码里updatePerson生成的对象是两个独立实例——哪怕属性完全一致，引用地址也不相同，所以存根匹配失败。

解决参数匹配的几种可行方案 #

方案一：使用Mockito属性匹配器

用refEq()匹配属性完全相同的对象（无需重写equals方法）：

import static org.mockito.ArgumentMatchers.refEq;

void test() {
 Person person = Person.builder()
   .setName("Name")
   .build();
 Person updatedPerson = Person.builder()
   .setName("Name")
   .setActive(true)
   .build();
 when(personService.getPersonById(1L)).thenReturn(person);
 // 用refEq替代直接传对象，按属性匹配
 when(validationService.isValid(refEq(updatedPerson))).thenReturn(false);
 // 执行测试逻辑
}

如果你的Person类已经重写了equals和hashCode（比如用Lombok的@EqualsAndHashCode），也可以用更简洁的eq()：

import static org.mockito.ArgumentMatchers.eq;

when(validationService.isValid(eq(updatedPerson))).thenReturn(false);

方案二：复用业务代码生成测试对象

直接调用被测类的updatePerson方法生成updatedPerson，这样和业务代码中生成的对象引用完全一致：

void test() {
 Person person = Person.builder()
   .setName("Name")
   .build();
 // 调用被测实例的updatePerson方法生成目标对象
 Person updatedPerson = yourTestClassInstance.updatePerson(person);
 when(personService.getPersonById(1L)).thenReturn(person);
 when(validationService.isValid(updatedPerson)).thenReturn(false);
 // 执行测试逻辑
}

方案三：给Person类重写equals和hashCode

用Lombok的@EqualsAndHashCode注解自动生成按属性比较的equals方法：

@SuperBuilder(setterPrefix = "set", toBuilder = true)
@EqualsAndHashCode // 新增该注解
class Person {
  private final String name;
  private final boolean active;
}

这样两个属性相同的Person实例会被判定为相等，Mockito默认的参数匹配就能直接生效。

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