本文介绍在 groovy（尤其是 spock 框架）中对接受 list 参数的方法进行 mock 时，如何通过自定义参数匹配器忽略元素顺序，确保测试稳定可靠。

本文介绍在 groovy（尤其是 spock 框架）中对接受 list 参数的方法进行 mock 时，如何通过自定义参数匹配器忽略元素顺序，确保测试稳定可靠。

在 Groovy 单元测试（特别是使用 Spock 框架）中，当被测方法接收 List 类型参数且语义上不依赖元素顺序（例如校验集合内容而非排列）时，若直接按固定顺序设置期望值，极易因实际调用时列表顺序不同而导致测试间歇性失败。

标准的 mockClass.foo(list) >> "test" 写法要求传入的 List 实例与预设 list 完全相等（包括顺序），而 List.equals() 默认按索引逐项比对，因此 ["a","b","c"] 与 ["c","a","b"] 被视为不等。

✅ 正确做法是使用 自定义参数匹配器（如 argThat），将匹配逻辑从“精确相等”升级为“内容一致”。核心思路是：对实际传入的列表和期望列表分别排序后比较：

// 在 given: 或 when: 块中设置期望
mockClass.foo(argThat { it.sort() == ["a", "b", "c"].sort() }) >> "test"

⚠️ 注意：argThat 并非 Spock 原生关键字，需手动定义（通常放在 setup: 或 given: 中，或提取为工具方法）：

// 推荐定义为可复用的闭包
def argThat = { Closure<boolean> predicate ->
    return { Object arg -> predicate.call(arg) } as org.hamcrest.Matcher
}</boolean>

完整 Spock 测试示例：

class MyServiceSpec extends Specification {
    def mockClass = Mock(MyClass)

    def "foo returns test when list contains a,b,c in any order"() {
        given:
            def argThat = { Closure<boolean> p ->
                { p(it) } as org.hamcrest.Matcher
            }

            mockClass.foo(argThat { it*.toString().sort() == ["a", "b", "c"].sort() }) >> "test"

        when:
            def result = mockClass.foo(["c", "a", "b"]) // 乱序传入

        then:
            result == "test"
    }
}</boolean>

? 补充建议：

• 若项目已引入 Hamcrest 或 AssertJ，可优先使用其内置集合匹配器（如 hasItems("a","b","c") + containsInAnyOrder），语义更清晰；
• 对于含重复元素的场景，sort() 可能不够健壮，推荐改用 toSet() 比较（适用于无重复需求）或 countBy{it} 统计频次；
• 避免在 argThat 中执行耗时操作，确保测试性能。

通过将匹配逻辑显式声明为“内容等价”，不仅解决了顺序敏感问题，也使测试意图更明确、更符合领域语义。