使用Mockito进行JUnit测试时遇参数不匹配错误：Actual invocation has different arguments

这个问题我之前踩过好几次坑！本质上就是Mockito在验证方法调用时，发现你预期的参数和代码实际执行时传入的参数不相等，它对参数匹配的校验非常严格。结合你给出的Project实体类代码，我给你梳理几个最常见的原因和解决办法：

1. 实体类未重写equals()和hashCode()方法 #

这是最常见的原因！因为Project是自定义实体类，如果没有重写这两个方法，Java默认会用对象的内存地址来判断是否相等——哪怕两个Project对象的id、name、language字段完全一样，Mockito也会认为它们是不同的对象，从而抛出参数不匹配的错误。

解决办法：给Project类重写equals()和hashCode()方法，基于你关心的字段来判断相等性：

import java.util.Objects;

@Entity
@Table(name = "projects")
public class Project {
    // 你的原有字段和注解...
    
    @Override
    public boolean equals(Object o) {
        if (this == o) return true;
        if (o == null || getClass() != o.getClass()) return false;
        Project project = (Project) o;
        return Objects.equals(id, project.id) &&
                Objects.equals(name, project.name) &&
                Objects.equals(language, project.language);
    }

    @Override
    public int hashCode() {
        return Objects.hash(id, name, language);
    }

    // 你的getter、setter方法...
}

2. 直接用对象实例验证，而非参数匹配器 #

如果你的业务代码里是动态生成Project对象（比如从数据库查询、或者通过DTO转换），而你在测试里手动new了一个Project作为验证参数，哪怕字段值看起来一样，也可能因为一些隐藏细节（比如id未赋值、某个字段为null）导致不匹配。这时候可以用Mockito的参数匹配器来灵活匹配：

场景1：只关心参数类型 #

如果你不关心Project的具体字段值，只需要验证方法确实被调用过，用any()匹配器：

import static org.mockito.ArgumentMatchers.any;
import static org.mockito.Mockito.verify;

// 验证projectService的save方法被调用过一次，参数是任意Project对象
verify(projectService).save(any(Project.class));

场景2：需要匹配特定字段值 #

如果你需要验证参数的某个或某几个字段符合预期，用argThat()自定义匹配逻辑：

import static org.mockito.ArgumentMatchers.argThat;
import static org.mockito.Mockito.verify;

// 验证save方法传入的Project对象name是"Test Project"，language是"Java"
verify(projectService).save(argThat(project -> 
    "Test Project".equals(project.getName()) && 
    "Java".equals(project.getLanguage())
));

3. 参数存在细微差异 #

有时候看起来参数一样，但实际有细微差别：

• 字符串的大小写、前后空格（比如实际传的是"test project"，你验证时写的是"Test Project"）
• 字段为null的情况（比如业务代码里language是null，但你测试里给language赋值了）

解决办法：在测试里打个断点，或者通过调试日志打印实际调用的参数，仔细核对预期和实际的参数差异。

内容的提问来源于stack exchange，提问作者P. Aiello