基于公司的业务需求,在SpringCloud Gateway组件的基础上,写了一个转发服务,测试开发阶段运行正常,并实现初步使用。但三个月后,PostMan请求接口,返回异常,经排查,从日志中获取到转发响应的结果为乱码:
跟踪日志:
转发到目标接口,响应结果已乱码。一般排查的思路是,查看请求方和响应方的编码格式是否一致,打印请求方的编码格式为UTF-8,响应服务的编码格式也是UTF-8。
以上说明编码格式没有问题。上网去找“gateway响应结果乱码”的相关文章,大多数会提供解决方案:
DataBufferFactory dataBufferFactory = new DefaultDataBufferFactory();
DataBuffer join = dataBufferFactory.join(dataBuffers);
byte[] content = new byte[join.readableByteCount()];
join.read(content);
// 释放掉内存
DataBufferUtils.release(join);
String str = new String(content, Charset.forName("UTF-8"));
originalResponse.getHeaders().setContentLength(str.getBytes().length);
System.out.println(str);
return bufferFactory.wrap(str.getBytes());
这段关键代码,在我的响应结果包装过滤器是有的,如下:
/**
* 获取到解码方的response,验签--->重新封装--->加签
* 通过 DataBufferFactory 解决响应体分段传输问题。
*/
private ServerHttpResponseDecorator verifyRePackageSignatureResponse(ServerWebExchange exchange, String jmf_decode_url, String route_privateKey, String jmf_publicKey) {
ServerHttpResponse response = exchange.getResponse();
log.debug("R:给响应结果response设置编码格式----START----");
response.getHeaders().add("Content-Type","application/json;charset=UTF-8");
log.debug("R:给响应结果response设置编码格式-----END-----");
DataBufferFactory bufferFactory = response.bufferFactory();
return new ServerHttpResponseDecorator(response) {
@Override
public Mono<Void> writeWith(Publisher<? extends DataBuffer> body) {
if (body instanceof Flux) {
// 获取响应类型,如果是 json 就打印
String originalResponseContentType = exchange.getAttribute(ServerWebExchangeUtils.ORIGINAL_RESPONSE_CONTENT_TYPE_ATTR);
log.debug("响应类型为originalResponseContentType:{}",originalResponseContentType);
if (RequestResponseUtil.isJson(originalResponseContentType)) {
Flux<? extends DataBuffer> fluxBody = Flux.from(body);
return super.writeWith(fluxBody.buffer().map(dataBuffers -> {
// 合并多个流集合,解决返回体分段传输
DataBufferFactory dataBufferFactory = new DefaultDataBufferFactory();
DataBuffer join = dataBufferFactory.join(dataBuffers);
byte[] content = new byte[join.readableByteCount()];
join.read(content);
// 释放掉内存
DataBufferUtils.release(join);
// 正常返回的数据
String rootData = new String(content, StandardCharsets.UTF_8);
log.debug("R:正常返回的数据rootData为:{}", rootData);
//使用枚举 + 工厂 + 策略模式(第二版)
String newQqtBodyJson = null;
try {
newQqtBodyJson = DecoderSignStrategyContext.zwmVerifySignResponse(rootData, jmf_decode_url, route_privateKey, jmf_publicKey);
log.debug("R:【码路由服务】经具体策略处理,得到结果newQqtBodyJson为:{}", newQqtBodyJson);
} catch (Exception e) {
log.error("R:【码路由服务】解码方返回结果验签异常:{}", e);
throw new VerifySignException(StaticVar.FAIL_10020015, "R:【码路由服务】解码方返回结果验签异常");
}
byte[] respData = newQqtBodyJson.getBytes();
//byte[] respData = newQqtBodyJson.getBytes(StandardCharsets.UTF_8);
byte[] uppedContent = new String(respData, Charset.forName("UTF-8")).getBytes();
return bufferFactory.wrap(uppedContent);
}));
} else {
log.error("响应结果异常");
throw new ProcessHandleException(StaticVar.FAIL_10020015, "R:【码路由服务】解码方返回结果异常,非法JSON");
}
}
// if body is not a flux. never got there.
return super.writeWith(body);
}
};
}
因此不是代码的问题。又找到了一篇文章,解决了PostMan请求的问题。
https://bbs.csdn.net/topics/399102026/close文章来源:https://www.toymoban.com/news/detail-758743.html
如上所述,在PostMan请求的headers中去掉Accept-Encoding,请求成功:
至此,PostMan请求乱码的问题已解决。但事情似乎没有那么简单,接下来,使用手机模拟扫码,请求码路由服务,又出现了乱码,扫码结果页面,返回结果:
查看日志,乱码如下:
排查问题进入瓶颈期,有些烦躁了,必须冷静下来,重新捋一下代码,同时也在想,既然和PostMan请求存在同样的问题,是不是在请求头中默认会有一个Accept-Encoding属性,从而导致了乱码,根据这个思路,在自定义的请求转发过滤器中,发现了以下代码:
由于在请求转发的逻辑中,重新构建了一个request请求的同时,重新创建了一个请求头headers,它在重新构建的时候默认会有一个accept-encoding属性,看到这一行代码时,正印证了以上我的猜想,问题已经找到了,将其置为空字符串即可(注意:不能使其为null,也不能remove这个属性,会报错)。
将headers的accept-encoding属性置为空字符串,并添加注释如下:
// 定义新的消息头
HttpHeaders headers = new HttpHeaders();
//System.out.println("headers = " + headers); //查看重新定义消息头的内容
headers.putAll(exchange.getRequest().getHeaders());
// 由于修改了传递参数,需要重新设置CONTENT_LENGTH,长度是字节长度,不是字符串长度
int length = bodyStr.getBytes().length;
log.debug("bodyStr长度为:{}",length);
headers.remove(HttpHeaders.CONTENT_LENGTH);
// 设置CONTENT_TYPE
if (StringUtils.isNotBlank(contentType)) {
headers.set(HttpHeaders.CONTENT_TYPE, contentType);
}
String jmf_decode_url = request.getURI().toString();
String qqtBodyJsonStr = JSONUtils.toString(bizPackage);
//request.mutate().header(HttpHeaders.CONTENT_LENGTH, Integer.toString(bodyStr.length())); //报错JSON parse error JsonEOFException,长度必须为字节的长度
request.mutate().header(HttpHeaders.CONTENT_LENGTH, Integer.toString(length));//成功,解决JSON parse error JsonEOFException
/**
* 乱码现象:请求响应结果乱码
* 解决过程分为PostMan请求和手机端App扫码请求:
* (1)、PostMan请求响应乱码解决:
* PostMan请求的headers中默认会有"Accept-Encoding"属性,值为"gzip, deflate, br",导致响应结果乱码
* 去掉Accept-Encoding后请求正常。
*
* (2)、手机端App扫码请求乱码解决:
* 在HttpRequestSignForwardGatewayFilter中定义新的消息头,headers中默认会有"accept-encoding"属性,
* 值为"gzip, deflate, br", 添加代码"request.mutate().header("accept-encoding",""); "解决乱码
*
* 注意: 创建headers对象默认会生成“accept-encoding=‘gzip, deflate, br‘ ”属性,此处必须将accept-encoding
* 置为空字符串(置为null会报错),否则使用默认值会导致响应结果乱码。
* 说明: 测试开发阶段未发生此问题,第三方检测时演示出现此问题,这个可能是gateway内部的问题,尚未可知。
*
* 经测试,这种方式已解决了:手机端APP扫码和PostMan响应结果乱码的问题(PostMan请求时可以不用刻意去掉Accept-Encoding,
* 也可请求成功)
*
*/
request.mutate().header("accept-encoding","");
重启后,部署后问题得到解决。这个问题在测试开发阶段没有暴露出来,按理说应该早暴露了,但现实情况就是这么诡异,这可能是Gateway内部的bug,尚未可知。
希望此文对遇到同样问题的小伙伴有所帮助和启发,望了解gateway内部原理机制的大神,参与讨论。
乱码问题已排查并处理结束,完结,撒花!
参考文章:
RestTemplate请求头accept-encoding导致乱码_resttemplate 乱码_AE86Jag的博客-CSDN博客
https://bbs.csdn.net/topics/399102026/close
在此感谢文章作者!文章来源地址https://www.toymoban.com/news/detail-758743.html
到了这里,关于记一次线上bug排查-----SpringCloud Gateway组件 请求头accept-encoding导致响应结果乱码的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!