Mockito.verify()与Specifications配合失效问题排查

我一眼就看出问题所在了——你在单元测试里遇到的参数不匹配，核心原因是Mockito默认按对象引用进行参数匹配，你在Service方法里new PhoneSpecification(filter)创建的实例，和测试代码里new PhoneSpecification(filter)创建的是两个完全独立的对象，哪怕它们的filter内容一模一样，Mockito也会认为这两个参数不相等，所以verify就失败了。

下面给你几个可行的解决方案，按推荐程度排序：

1. 为PhoneSpecification重写equals和hashCode方法 #

既然两个Spec实例的核心差异是内部的filter，那我们可以让PhoneSpecification基于filter的属性来判断相等性。最简单的方式是用Lombok的@EqualsAndHashCode注解：

@EqualsAndHashCode
public class PhoneSpecification implements Specification<Phone> {
    private final PhoneFilter filter;

    public PhoneSpecification(PhoneFilter filter) {
        this.filter = filter;
    }

    // 你的toPredicate实现...
}

当然你也可以手动重写这两个方法，只要保证当两个filter的属性完全一致时，两个Spec实例的equals返回true即可。这样Mockito在匹配参数时，就会认为这两个Spec是相等的，verify就能通过了。

2. 使用Mockito的argThat匹配器自定义参数匹配逻辑 #

如果你不想修改PhoneSpecification的代码，可以用Mockito的ArgumentMatchers.argThat()来定义自定义的匹配规则，检查传入的Spec是否符合预期：

@Test
public void whenCallListWithEmptyFilterThenRepoIsCalledFindAll() {
    PhoneFilter filter = new PhoneFilter(new PageRequest(0 , 1));
    phoneService.list(filter);

    verify(phoneRepository).findAll(
        argThat(spec -> {
            // 断言传入的spec是PhoneSpecification类型，且内部的filter和测试用filter一致
            assertTrue(spec instanceof PhoneSpecification);
            PhoneSpecification phoneSpec = (PhoneSpecification) spec;
            return Objects.equals(phoneSpec.getFilter(), filter);
        }),
        eq(filter.getPageable())
    );
}

这里我们通过lambda表达式判断传入的Specification是否是PhoneSpecification，并且它的filter和测试用的filter相等（记得PhoneFilter也要正确重写equals哦）。

3. 抽离Specification的创建逻辑（适合复杂场景） #

如果你的Spec创建逻辑比较复杂，或者想更灵活地控制测试中的实例，可以把创建Spec的逻辑抽成一个单独的工厂类：

// 新增工厂类
public class PhoneSpecificationFactory {
    public Specification<Phone> create(PhoneFilter filter) {
        return new PhoneSpecification(filter);
    }
}

// Service层注入这个工厂
@Service
public class PhoneServiceImpl implements PhoneService {
    private final PhoneRepository phoneRepository;
    private final PhoneSpecificationFactory specFactory;

    public PhoneServiceImpl(PhoneRepository phoneRepository, PhoneSpecificationFactory specFactory) {
        this.phoneRepository = phoneRepository;
        this.specFactory = specFactory;
    }

    @Override
    public Page<Phone> list(@NonNull final PhoneFilter filter) {
        Specification<Phone> specs = specFactory.create(filter);
        return phoneRepository.findAll(where(specs), filter.getPageable());
    }
}

然后在测试里mock这个工厂，让它返回你预先创建好的Spec实例：

@Test
public void whenCallListWithEmptyFilterThenRepoIsCalledFindAll() {
    PhoneFilter filter = new PhoneFilter(new PageRequest(0 , 1));
    PhoneSpecification expectedSpec = new PhoneSpecification(filter);
    when(specFactory.create(filter)).thenReturn(expectedSpec);

    phoneService.list(filter);

    verify(phoneRepository).findAll(where(expectedSpec), filter.getPageable());
}

这种方式完全避免了实例不匹配的问题，因为Service和测试用的是同一个Spec实例。

额外小提示 #

单元测试的核心是验证行为是否符合预期，而不是纠结于具体的实现细节。你也可以选择捕获findAll方法的参数，然后断言这个参数的查询逻辑是否正确，而不是单纯验证传入的Spec实例是否一致。

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