API请求UTF8字符集乱码问题排查指南

1 问题描述

当第三方系统请求OpenAPI时，请求参数和返回参数中文字段出现乱码问题。

2 问题分析

乱码发生原因，一般是因为发送方与接收方编码不一致。比如发送方是GB2312，而苍穹接收统一要求为UTF-8。

3 解决方法

那么如何才能保证不会乱码？

• 【可选】请求头中声明UTF-8编码 httpPost.setContentType("application/json;charset="UTF-8")；如果没设置则默认UTF-8。

• 【可选】如果没指定请求头则可以设置：httpPost.addHeader("Accept-Charset", "UTF-8");

• 【必须】确保http请求中的报文body，传送的是真UTF-8编码报文。如果不是UTF-8编码，可以通过以下语句进行转换：

            StringEntity entity = new StringEntity(jsonData, "UTF-8");//解决中文乱码问题

            entity.setContentType("application/json;charset="UTF-8");

            httpPost.setEntity(entit