Mockito ArgumentMatchers.refEq如何排除嵌套字段实现参数匹配

首先明确核心结论：Mockito原生的ArgumentMatchers.refEq()不支持点分隔的嵌套字段排除路径。
你写refEq(user, "address.city")不生效的原因很简单：refEq的排除字段逻辑只会识别被匹配对象（这里是User实例）的直接属性名，不会递归解析嵌套路径——User类里没有名为address.city的直接属性，所以这条排除规则完全没生效，匹配器还是会递归比对address下的所有字段，同时还会把CGLIB代理生成的合成字段、父类隐藏字段一并纳入比对，这也是你直接用无排除规则的refEq(user)时，明明业务属性全一致还是匹配失败的常见原因。
你之前传"address"能正常匹配，是因为User类确实存在名为address的直接属性，匹配器会直接跳过整个address字段的所有比对，这和你只想排除address下city字段的需求不匹配。

可行实现方案 #

方案1：自定义ArgumentMatcher（零额外依赖，最可控） #

用argThat自定义匹配逻辑，逐层级校验需要比对的字段，直接跳过要排除的嵌套字段即可，示例代码：

// 提前构造你预期的基准User对象，只设置需要校验的属性值
User expected = new User();
expected.setName("testName");
expected.setLastName("testLast");
Address expectedAddr = new Address();
expectedAddr.setStreet("testStreet");
expected.setAddress(expectedAddr);

// mock时用自定义匹配规则
doReturn(LocalDateTime.now())
    .when(yourSpyInstance)
    .getLastLogin(argThat(actualUser -> {
        // 校验User顶层字段
        if (!Objects.equals(actualUser.getName(), expected.getName())) return false;
        if (!Objects.equals(actualUser.getLastName(), expected.getLastName())) return false;
        
        Address actualAddr = actualUser.getAddress();
        if (actualAddr == null) return false;
        // 校验Address层需要保留的字段，直接跳过city字段不做校验
        return Objects.equals(actualAddr.getStreet(), expectedAddr.getStreet());
    }));

这个方案没有额外依赖，逻辑完全透明，不会因为框架生成的隐藏字段出现莫名其妙的匹配失败问题。

方案2：配合AssertJ递归比较（代码最简洁，推荐项目已引入AssertJ时使用） #

如果你的单元测试已经引入AssertJ依赖，可以直接用它原生支持嵌套路径排除的递归比较能力，不用逐字段写判断：

User expected = buildExpectedUser(); // 构造全量预期值即可，不需要手动裁剪字段

doReturn(LocalDateTime.now())
    .when(yourSpyInstance)
    .getLastLogin(argThat(actualUser -> {
        Assertions.assertThat(actualUser)
            .usingRecursiveComparison()
            .ignoringFields("address.city") // 原生支持点分隔嵌套路径排除
            .isEqualTo(expected);
        return true;
    }));

注意：如果比较过程抛出AssertionError，会直接导致匹配失败，不需要额外写判断逻辑。

额外提醒 #

你要mock的getLastLogin是私有方法，需要依赖Mockito-inline（Mockito 3.4+支持）或者PowerMock的能力才能mock，这个不影响上述参数匹配规则的生效。

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