Groovy Spock测试Mock RestTemplate.exchange()抛出MissingMethodException问题

问题根源拆解 #

1. MissingMethodException（HttpEntity下标访问错误）：Groovy的动态特性会把类似httpEntity[0]的写法自动转成调用getAt(0)方法，但HttpEntity类并没有这个方法。这通常是Mock时参数匹配太宽松（比如直接用_通配符），导致Groovy对HttpEntity参数进行了不必要的语法解析触发的。
2. ResponseEntity Stub引发的NPE：多数是因为Stub的ResponseEntity未正确初始化，或者getBody()的Stub逻辑未生效，导致调用时返回null。

具体解决步骤 #

1. 修正exchange()的Mock参数匹配 #

避免使用无类型的通配符_匹配HttpEntity参数，改用精确的类型匹配或具体实例匹配，防止Groovy触发不必要的方法调用：

def "测试exchange方法调用"() {
    given:
    def restTemplate = Mock(RestTemplate)
    // 构造真实的响应体和ResponseEntity实例（比Stub更可靠）
    def mockResponseBody = new YourBusinessResponse() // 你的业务响应类
    def responseEntity = new ResponseEntity<>(mockResponseBody, HttpStatus.OK)
    // 构造请求头和请求实体
    def requestHeaders = new HttpHeaders()
    requestHeaders.add("X-Custom-Header", "test-value")
    def requestEntity = new HttpEntity<>(new YourRequestObject(), requestHeaders)

    when:
    def result = yourService.callApi(restTemplate) // 调用业务方法

    then:
    // 精确匹配exchange的所有参数，HttpEntity用类型限定避免Groovy解析异常
    1 * restTemplate.exchange(
        "https://your-target-api.com/path",
        HttpMethod.POST,
        _ as HttpEntity, // 用类型匹配任意HttpEntity实例
        YourBusinessResponse.class
    ) >> responseEntity
}

2. 用真实ResponseEntity实例替代Stub #

ResponseEntity是简单的容器类，直接通过构造方法创建真实实例即可，无需Stub，这样getBody()自然会返回你设置的响应体，从根源避免NPE：

// 错误写法：Stub ResponseEntity可能导致NPE
// def responseEntity = Mock(ResponseEntity)
// responseEntity.getBody() >> mockResponseBody

// 正确写法：直接构造真实实例
def responseEntity = new ResponseEntity<>(mockResponseBody, HttpStatus.OK)

3. 检查参数匹配的一致性 #

确保Mock的exchange()方法参数，和业务代码中实际调用的参数完全匹配：

• URL路径、HTTP方法（GET/POST等）必须一致
• 响应类型（即最后一个参数的Class对象）必须和业务代码中的调用一致
• 如果业务代码中HttpEntity的请求体或头有特定值，Mock时也可以用具体实例匹配而非类型匹配

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