SpringBoot项目使用RestTemplate发送请求踩坑记录

开发背景

系统要对接飞鹅云打印机进行打印，需要通过指定接口打印数据
因为使用SpringBoot开发，刚好用RestTemplate+postForObject发送POST请求并接受结果。

设置请求头(Content-Type)

接口要求请求头中要带Content-Type: application/x-www-form-urlencoded

思路:
先创建个实现ClientHttpRequestInterceptor接口的类，在intercept(…)方法中对请求头设置，在使用RestTemplate的时候设置或添加这个Interceptor类，然后再发送请求

MyPostInterceptor类：

@Component
public class MyPostInterceptor implements ClientHttpRequestInterceptor {private Logger logger = LoggerFactory.getLogger(this.getClass());//设置默认请求头为application/x-www-form-urlencodedprivate MediaType mediaType = MediaType.APPLICATION_FORM_URLENCODED;/***参考链接https://www.cnblogs.com/yihuihui/p/13211699.html*/@Overridepublic ClientHttpResponse intercept(HttpRequest request, byte[] body, ClientHttpRequestExecution execution) throws IOException {//设置请求头request.getHeaders().setContentType(mediaType);//另一种设置方法
//        request.getHeaders().add("Content-Type",MediaType.APPLICATION_FORM_URLENCODED_VALUE);logger.info("===request: {}, {}, {}", request.getURI().getHost(), request.getURI().getPath(),request.getHeaders());logger.info("===requestBody: {}", new String(body,UTF_8));return execution.execute(request, body);}//Get/Set忽略
}

发送请求：

 //myPostInterceptor自动注入省略...//构建数据实体类feiEPrintBody...RestTemplate restTemplate = new RestTemplate();//设置请求类型,NORMAL_HEADER=MediaType.APPLICATION_FORM_URLENCODEDmyPostInterceptor.setMediaType(NORMAL_HEADER);restTemplate.setInterceptors(Collections.singletonList(myPostInterceptor));//另一种设置方法
//  restTemplate.getInterceptors().add(myPostInterceptor);//增加返回消息转换类，详见下方踩坑1restTemplate.getMessageConverters().add(new PostMappingJackson2HttpMessageConverter());//提交数据并获取结果，这里也有坑，详见踩坑2//OPEN_API为接口网址JSONObject result = restTemplate.postForObject(OPEN_API,feiEPrintBody.builderMultiValueMap(),JSONObject.class);

踩坑1

RestTemplate的默认处理响应类型为application/json，但接口返回数据格式为text/html，RestTemplate无法转换信息报错：UnknownContentTypeException

org.springframework.web.client.UnknownContentTypeException: Could not extract response: no suitable HttpMessageConverter found for response type [class com.alibaba.fastjson.JSONObject] and content type [text/html;charset=UTF-8]at org.springframework.web.client.HttpMessageConverterExtractor.extractData(HttpMessageConverterExtractor.java:126)...

解决：给RestTemplate增加一个处理指定响应数据类型的HttpMessageConverter
这里知道接口返回的是json格式，所以这里继承spring中默认的MappingJackson2HttpMessageConverter

/*** POST返回信息 TEXT_HTML转换类* 参考https://blog.csdn.net/kinginblue/article/details/52706155*/
public class PostMappingJackson2HttpMessageConverter extends MappingJackson2HttpMessageConverter {public PostMappingJackson2HttpMessageConverter(){List<MediaType> mediaTypes;mediaTypes = new ArrayList<>();//设置消息转换类的响应类型mediaTypes.add(MediaType.TEXT_HTML);setSupportedMediaTypes(mediaTypes);}
}

踩坑2

设置请求头后，一开始使用以下方式发送数据，接口报错，一开始以为是请求头设置没有生效找了半天

//feiEPrintBody为pojo
JSONObject result = restTemplate.postForObject(OPEN_API,feiEPrintBody,JSONObject.class);

后面经群友提示，application/x-www-form-urlencoded不能传json格式的body，排查后发现，直接传对象会被RestTemplate转为json格式，修改后才解决

解决：改用LinkedMultiValueMap存字段
Tip：必须要使用LinkedMultiValueMap，用MultiValueMap仍有转为Json的问题
这里直接在存数据类里加个新建方法，然后在发送方法里调用

 //FeiEPrintBody构建传值mappublic MultiValueMap builderMultiValueMap() {LinkedMultiValueMap<String, Object> postParameters = new LinkedMultiValueMap<>();postParameters.add("user", getUser());postParameters.add("stime", getStime());postParameters.add("sig", getSig());postParameters.add("apiname", getApiName());postParameters.add("sn", sn);postParameters.add("content", content);if (times > 0) {postParameters.add("times", String.valueOf(times));}if (img != null) {postParameters.add("img", img);}return postParameters;}

//OPEN_API为接口网址
JSONObject result = restTemplate.postForObject(OPEN_API,feiEPrintBody.builderMultiValueMap(),JSONObject.class);

设置后提交的Body变化了，接口调用成功

解决后吐槽：快乐撸码五分钟，苦逼Debug两小时