如何在Mockito验证中对Map参数使用anyString()匹配器？

我正在使用Mockito和JUnit 5编写Spring Boot应用的单元测试，需要验证一个包含Map<String, String>参数的方法调用。方法签名如下：

public void someMethod(SomeClass obj, String parameter1, Map<String, String> properties) { ... }

需求是验证该方法被调用时，传入的Map满足：

• property1的值为固定字符串"TEST_VALUE"
• 包含property2和property3两个键，对应的值可以是任意非空字符串

测试代码尝试在Map.of()中直接使用anyString()匹配器，导致报错：

@Test
void testMethodVerification() {
    Map<String, String> properties = Map.of(
        "property1", "TEST_VALUE",
        "property2", anyString(), // 错误：匹配器不能直接用于创建Map
        "property3", anyString() // 错误：匹配器不能直接用于创建Map
    );

    verify(mockedService, times(1)).someMethod(
        any(SomeClass.class),
        eq("some_attribute"),
        eq(properties) // 错误：无法用eq()包装含匹配器的Map
    );
}

抛出异常：

org.mockito.exceptions.misusing.UnfinishedVerificationException: 
Missing method call for verify(mock) here:
-> at com.mycompany.myproject.MyTestClass.testMethodVerification(MyTestClass.java:XX)

原因是Mockito的参数匹配器（如anyString()）只能用于verify或when的方法参数位置，不能直接用来初始化对象。

方案1：使用argThat结合Lambda表达式（推荐） #

通过argThat()传入自定义的验证逻辑，直接在lambda中检查Map的各项条件：

import static org.mockito.ArgumentMatchers.argThat;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.times;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;

@Test
void testMethodVerification() {
    verify(mockedService, times(1)).someMethod(
        any(SomeClass.class),
        eq("some_attribute"),
        argThat(map -> {
            // 验证property1的固定值
            if (!"TEST_VALUE".equals(map.get("property1"))) {
                return false;
            }
            // 验证存在property2和property3，且值为非空字符串
            return map.containsKey("property2") 
                    && map.containsKey("property3")
                    && map.get("property2") instanceof String
                    && map.get("property3") instanceof String;
        })
    );
}

方案2：结合Hamcrest匹配器 #

如果项目已引入Hamcrest依赖，可以用更语义化的匹配器组合验证：

import static org.mockito.ArgumentMatchers.argThat;
import static org.hamcrest.Matchers.allOf;
import static org.hamcrest.Matchers.hasEntry;
import static org.hamcrest.Matchers.hasKey;
import static org.hamcrest.Matchers.notNullValue;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.times;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;

@Test
void testMethodVerification() {
    verify(mockedService, times(1)).someMethod(
        any(SomeClass.class),
        eq("some_attribute"),
        argThat(allOf(
            hasEntry("property1", "TEST_VALUE"),
            hasKey("property2"),
            hasKey("property3"),
            hasEntry("property2", notNullValue(String.class)),
            hasEntry("property3", notNullValue(String.class))
        ))
    );
}

注意：需确保依赖中包含org.mockito:mockito-hamcrest或org.hamcrest:hamcrest-library。

方案3：使用Mockito内置的Map匹配器 #

利用Mockito的hasEntry和hasKey匹配器组合验证：

import static org.mockito.AdditionalMatchers.and;
import static org.mockito.ArgumentMatchers.hasEntry;
import static org.mockito.ArgumentMatchers.hasKey;
import static org.mockito.Mockito.verify;
import static org.mockito.Mockito.times;
import static org.mockito.ArgumentMatchers.any;
import static org.mockito.ArgumentMatchers.eq;

@Test
void testMethodVerification() {
    verify(mockedService, times(1)).someMethod(
        any(SomeClass.class),
        eq("some_attribute"),
        and(
            hasEntry("property1", "TEST_VALUE"),
            hasKey("property2"),
            hasKey("property3")
        )
    );
}

这种方式简洁，但仅验证键的存在和property1的值，若需要验证值的类型或非空，还是推荐前两种方案。

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