JUnit模拟restTemplate.exchange POST请求报HttpMethod is required错误如何解决

问题原因 #

你遇到的异常本质是Mock规则未命中实际的restTemplate.exchange调用，Mockito未拦截到对应方法调用时会触发RestTemplate真实逻辑执行，真实方法内部校验HttpMethod参数时抛出该异常。常见触发原因有两类：

• Mockito 2.x及以上版本中，Mockito.any()默认不匹配null值，如果业务代码调用exchange时第三个参数（HttpEntity）传的是null，当前写的Mockito.any()会匹配失败
• 没有匹配到正确的exchange重载方法：你当前Stub的是4参数的exchange重载，如果业务代码实际调用的是带uri可变参数的5参数重载、或带ParameterizedTypeReference的重载，也会匹配失败

修复方案 #

场景1：业务代码会传null作为HttpEntity #

将Mockito.any()替换为可匹配null值的Mockito.nullable()，指定匹配类型为HttpEntity即可：

Mockito.when(restTemplate.exchange(
                anyString(),
                Mockito.eq(HttpMethod.POST),
                Mockito.nullable(HttpEntity.class),
                Mockito.eq(String.class)
        )).thenReturn(new ResponseEntity<>(HttpStatus.OK));

场景2：重载方法不匹配 #

如果业务代码实际调用的是带uri可变参数的5参数重载，补全可变参数的匹配规则即可：

Mockito.when(restTemplate.exchange(
                anyString(),
                Mockito.eq(HttpMethod.POST),
                Mockito.nullable(HttpEntity.class),
                Mockito.eq(String.class),
                Mockito.any()
        )).thenReturn(new ResponseEntity<>(HttpStatus.OK));

你也可以通过Mockito.verify(restTemplate).exchange(...)打印实际调用的参数，确认匹配规则是否符合预期。

内容的提问来源于stack exchange，提问作者Aishu.dars