RestTemplate调用远程接口的总是不通？

最新推荐文章于 2024-06-22 20:48:43 发布

失落的秘符99

最新推荐文章于 2024-06-22 20:48:43 发布

阅读量2.8k

点赞数 1

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/u012464024/article/details/106607006

本文介绍了使用RestTemplate调用远程接口时遇到的问题及解决思路。通过对比RestTemplate请求与Postman请求的header和body，找出两者不一致的地方，发现问题在于请求体的数据格式。将MultiValueMap转换为HashMap，使请求体符合JSON key-value格式，从而解决了调用失败的问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

很多同学在问我，RestTemplate调用远程第三方接口总是报错的问题，在这里提一下，因为思路其实非常简单，但问我的同学却很无处下手，希望可以帮到大家。

RestTemplate其实就是http协议的生成并调用，作用同第三方http client工具，只是一个是工具一个是代码，但功能完全一致。在不知道怎么调试的时候，除了可以看源码，还有中非常简单的方式，就是打印出request的header、body去对比，对比看是否和postman等第三方工具的header、body是否一致？
如果不一致，那么不一致的地方就是调用失败的原因。

因为RestTemplate的本质就是遵守HTTP协议的规范，如果postman调用没有问题，那么一定是RestTemplate的header或者body中的数据格式问题。

下面会举例一个具体的例子说明：

失败


	RestTemplate restTemplate = new RestTemplate();
    MultiValueMap<String, Object> paramMap = new LinkedMultiValueMap<>();
    paramMap.add("id", "rtyuiogh");
    paramMap.add("machineId", "test_v1.1");
    paramMap.add("goodsId", "test_v1.1");
    paramMap.add("amount", 78);
    SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    paramMap.add("time", dateFormat.format(new Date()));

    HttpHeaders httpHeaders = new HttpHeaders();
    MediaType type = MediaType.parseMediaType("application/json; charset=UTF-8");
    httpHeaders.setContentType(type);
    HttpEntity<MultiValueMap<String, Object>> requestEntity = new HttpEntity<>(paramMap, httpHeaders);

    System.out.println("request-headers: " + requestEntity.getHeaders());
    System.out.println("request-body: " + requestEntity.getBody());

    String url = "http://localhost:8080/test/";
    ResponseEntity<String> responseEntity =
            restTemplate.postForEntity(url, requestEntity, String.class);
    System.out.println(responseEntity.getBody());

结果展示：
request-headers: {Content-Type=[application/json;charset=UTF-8]}
request-body: {id=[rtyuiogh], machineId=[test_v1.1], goodsId=[test_v1.1], amount=[78], time=[2020-06-13 18:23:33]}

看到body中把每个字段都封装到一个list中，但我们实际在postman中访问时，只是一个json的key-value格式，并不是list。这个和postman不一致的部分就是问题所在啦。
解决方式，就是将MultiValueMap 变为HashMap即可

成功

	
	RestTemplate restTemplate = new RestTemplate();
    HashMap<String, Object> params = new HashMap<String, Object>();
    params.put("id", "rtyuiogh");
    params.put("machineId", "test_v1.1");
    params.put("goodsId", "test_v1.1");
    params.put("amount", 78);
    SimpleDateFormat dateFormat = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
    params.put("time", dateFormat.format(new Date()));

    HttpHeaders httpHeaders = new HttpHeaders();
    MediaType type = MediaType.parseMediaType("application/json; charset=UTF-8");
    httpHeaders.setContentType(type);
    HttpEntity<HashMap<String, Object>> requestEntity = new HttpEntity<>(params, httpHeaders);

    System.out.println("request-headers: " + requestEntity.getHeaders());
    System.out.println("request-body: " + requestEntity.getBody());

    String url = "http://localhost:8080/test/";
    ResponseEntity<String> responseEntity =
            restTemplate.postForEntity(url, requestEntity, String.class);
	System.out.println(responseEntity.getBody());

结果展示：
request-headers: {Content-Type=[application/json;charset=UTF-8]}
request-body: {amount=78, machineId=test_v1.1, goodsId=test_v1.1, id=rtyuiogh, time=2020-06-13 18:09:37}

我们可以明显看到请求体body已经不是list了，而是一个普通的json，这样的body才是接口要求的，也和postman的格式保持一致。那么这样的请求就是没有问题的了。