常见问题
常见问题

请求或响应问题

1,参数值乱码或缺失

检查是否UTF-8编码
//以HttpClient为例
//a: 一般Get请求默认为此类型
import org.apache.http.client.methods.HttpGet;
httpGet.setHeader("Content-Type","application/x-www-form-urlencoded;charset=UTF-8");
//或者b: post方式设置body格式为json
import org.apache.http.client.methods.HttpPost;
httpPost.setHeader("Content-Type","application/json;charset=UTF-8");
//c: 同时设置可能会报错,本文档也并无Post方式接口同时传递query参数和body参数
是否对请求参数进行encode
当发送get请求(或类似post请求:url?key=中文和特殊符号),即本文档中所指的query参数,由于参数实际是以拼接在url后方的方式进行参数传递的,如果不对中文或非ascii字符进行urlEncode,则会出现参数值乱码或丢失的情况。此时可对参数值进行urlEncode后,再进行参数设置并发送请求。
//以HttpClient为例
// 传入的query参数
Map<String,String> queryParamMap ...;
//开始设置http请求参数
List<NameValuePair> param = new ArrayList<>();
for (Map.Entry<String, String> entry : paramMap.entrySet()) {
param.add(new BasicNameValuePair(entry.getKey(),entry.getValue()) );
}
httpPost.setEntity(new UrlEncodedFormEntity(param, StandardCharsets.UTF_8));
//当传入的是body参数时
httpPost.setEntity(
new StringEntity(json,
ContentType.create("application/json", StandardCharsets.UTF_8)));
结果解析时,是否设定为UTF-8编码
收到服务端结果时,Header部分一般为数字或英文字符组成,不会出现乱码。body部分请使用UTF-8编码进行接收。
//http response
String result = EntityUtils.toString(response.getEntity(),StandardCharsets.UTF_8);

2,签名问题

1,打印或手工拼接出签名校验不通过的请求的签名内容字符串,使用工具进行HMAC-SHA256签名,比较和发送请求时的签名是否一致,核对签名算法本身
2,对照签名步骤,检查签名内容字符串是否拼接无误,是否多了空值或空对象:'' "" {} 之类的,又是否有换行符的差异,如:\n \r\n
2,检查是否存在上方参数值乱码或缺失的问题,导致发送端的签名内容和服务端接收到的报文内容有差异,注意如果是对参数值以及body数据体,不是encode转码后的值进行签名
3,签名key是否正确

异常提示