spring-cloud-zuul文件上传中文名乱码解决过程

2023-11-03 05:08

本文主要是介绍spring-cloud-zuul文件上传中文名乱码解决过程,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

       由于项目中用到了zuul作为网关,所有的请求都要经过zuul转发,因此上传请求也被代理了。经过辛辛苦苦的敲代码,终于完成了功能开发,上传非中文名的文件一切都很完美,可是到了中文文件名时,文件服务器收到的请求里面中文名全部变成了 ‘?’ ,我也是有很多疑问了,同样的功能,咋就中文名称不行呢?难道这也有字符编码的问题?于是乎,开始网上找了,竟然发现都有同样的问题,不过zuul官方给出了解决方案,使用/zuul开头的请求可以避免中文名乱码以及支持大文件上传,于是乎,按照文档改了一波,没想到又有了新的问题,上传文件不能成功,服务器接收到的文件流总是不完整,经过断点调试,最终发现是某位同学挖的坑(自定义的可重复读过滤器中处理了所有的请求,应该放过上传文件的请求),填完后发现可以上传了,而且中文名也解决了,算是完成了整个功能。

      鉴于强迫症,为啥使用不带/zuul的请求上传就会有中文乱码呢,于是开始了跟踪定位。FormBodyWrapperFilter过滤器是zuul处理请求的第二个过滤器,主要功能就是将请求的流进行重新包装,主要逻辑是首先取contentData(从reqeust.getInputStream()来)数据,如果为空,则取request.getParts()数据,由于请求首先经过了dispatchServlet,因此只能从request.getParts()取数据,然后进行处理,具体处理的调用栈如图:

FormBodyWrapperFilter.FormBodyRequestWrapper类的getContentType()方法中调用了buildContentData(),也就是去获取contentData,上图的程序调用栈很清晰的反映了调用过程。FormBodyWrapperFilter中有个AllEncompassingFormHttpMessageConverter的对象作为convert的成员变量,而AllEncompassingFormHttpMessageConverter是FormHttpMessageConverter的子类,这个类的功能就是对请求form-data进行处理,而对于multipart/form-data请求处理时会用到FormHttpMessageConverter.MultipartHttpOutputMessage,是一个私有的静态类,也就是说无法对该类进行重写,该类中最终处理文件名的方法也就是调用栈图中的最后一个方法writeHeaders(),看下该方法的源码:

private void writeHeaders() throws IOException {if (!this.headersWritten) {for (Map.Entry<String, List<String>> entry : this.headers.entrySet()) {byte[] headerName = getAsciiBytes(entry.getKey());for (String headerValueString : entry.getValue()) {byte[] headerValue = getAsciiBytes(headerValueString);this.outputStream.write(headerName);this.outputStream.write(':');this.outputStream.write(' ');this.outputStream.write(headerValue);writeNewLine(this.outputStream);}}      writeNewLine(this.outputStream);this.headersWritten = true;}
}private byte[] getAsciiBytes(String name) {try {return name.getBytes("US-ASCII");}catch (UnsupportedEncodingException ex) {// Should not happen - US-ASCII is always supported.throw new IllegalStateException(ex);}
}

可以看到在遍历headers时,对于head中值的处理使用了getAsciiBytes(String name)方法,该方法的实现就是取字符串的“US-ASCII”编码的字节数组,那么对于中文字符串的处理就会有乱码的问题了。这里就是使用zuul代理上传时为什么中文名会乱码的根本原因了,那么问题来了,这个问题要怎么解决呢?可以看到该类是私有的内部类,是无法重写的,按理说这个问题应该早都有人发现了吧,于是乎,将spring-web版本升级到5.0.6.RELEASE版本后,查看该类的源代码:

private void writeHeaders() throws IOException {if (!this.headersWritten) {for (Map.Entry<String, List<String>> entry : this.headers.entrySet()) {byte[] headerName = getBytes(entry.getKey());for (String headerValueString : entry.getValue()) {byte[] headerValue = getBytes(headerValueString);this.outputStream.write(headerName);this.outputStream.write(':');this.outputStream.write(' ');this.outputStream.write(headerValue);writeNewLine(this.outputStream);}}writeNewLine(this.outputStream);this.headersWritten = true;}
}private byte[] getBytes(String name) {return name.getBytes(this.charset);
}

果然,源代码已经变了,从原来的getAsciiBytes(String name)变为了getBytes(String name),而getBytes(String  name)的实现会根据设定的字符编码来获取对应的字节数组,而这个字符编码是可以通过FormHttpMessageConverter.setCharset()方法来修改的,这样就不会有乱码的问题了。因此如果用zuul代理上传请求,且不能忽略中文名乱码时,要将spring-web版本升级到5.0.x

      至此,zuul代理上传请求,中文名乱码的问题算是解决了,虽然最终的解决方式很简单,只需要升级一下sping-web的版本,但是定位问题的过程还是比较有重要的,起码也熟悉了zuul处理请求的过程。

这篇关于spring-cloud-zuul文件上传中文名乱码解决过程的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/335792

相关文章

Spring Boot中WebSocket常用使用方法详解

《SpringBoot中WebSocket常用使用方法详解》本文从WebSocket的基础概念出发,详细介绍了SpringBoot集成WebSocket的步骤,并重点讲解了常用的使用方法,包括简单消... 目录一、WebSocket基础概念1.1 什么是WebSocket1.2 WebSocket与HTTP

SpringBoot+Docker+Graylog 如何让错误自动报警

《SpringBoot+Docker+Graylog如何让错误自动报警》SpringBoot默认使用SLF4J与Logback,支持多日志级别和配置方式,可输出到控制台、文件及远程服务器,集成ELK... 目录01 Spring Boot 默认日志框架解析02 Spring Boot 日志级别详解03 Sp

java中反射Reflection的4个作用详解

《java中反射Reflection的4个作用详解》反射Reflection是Java等编程语言中的一个重要特性,它允许程序在运行时进行自我检查和对内部成员(如字段、方法、类等)的操作,本文将详细介绍... 目录作用1、在运行时判断任意一个对象所属的类作用2、在运行时构造任意一个类的对象作用3、在运行时判断

java如何解压zip压缩包

《java如何解压zip压缩包》:本文主要介绍java如何解压zip压缩包问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录Java解压zip压缩包实例代码结果如下总结java解压zip压缩包坐在旁边的小伙伴问我怎么用 java 将服务器上的压缩文件解压出来,

SpringBoot中SM2公钥加密、私钥解密的实现示例详解

《SpringBoot中SM2公钥加密、私钥解密的实现示例详解》本文介绍了如何在SpringBoot项目中实现SM2公钥加密和私钥解密的功能,通过使用Hutool库和BouncyCastle依赖,简化... 目录一、前言1、加密信息(示例)2、加密结果(示例)二、实现代码1、yml文件配置2、创建SM2工具

Spring WebFlux 与 WebClient 使用指南及最佳实践

《SpringWebFlux与WebClient使用指南及最佳实践》WebClient是SpringWebFlux模块提供的非阻塞、响应式HTTP客户端,基于ProjectReactor实现,... 目录Spring WebFlux 与 WebClient 使用指南1. WebClient 概述2. 核心依

SQL Server配置管理器无法打开的四种解决方法

《SQLServer配置管理器无法打开的四种解决方法》本文总结了SQLServer配置管理器无法打开的四种解决方法,文中通过图文示例介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的... 目录方法一:桌面图标进入方法二:运行窗口进入检查版本号对照表php方法三:查找文件路径方法四:检查 S

Spring Boot @RestControllerAdvice全局异常处理最佳实践

《SpringBoot@RestControllerAdvice全局异常处理最佳实践》本文详解SpringBoot中通过@RestControllerAdvice实现全局异常处理,强调代码复用、统... 目录前言一、为什么要使用全局异常处理?二、核心注解解析1. @RestControllerAdvice2

Spring IoC 容器的使用详解(最新整理)

《SpringIoC容器的使用详解(最新整理)》文章介绍了Spring框架中的应用分层思想与IoC容器原理,通过分层解耦业务逻辑、数据访问等模块,IoC容器利用@Component注解管理Bean... 目录1. 应用分层2. IoC 的介绍3. IoC 容器的使用3.1. bean 的存储3.2. 方法注

Spring事务传播机制最佳实践

《Spring事务传播机制最佳实践》Spring的事务传播机制为我们提供了优雅的解决方案,本文将带您深入理解这一机制,掌握不同场景下的最佳实践,感兴趣的朋友一起看看吧... 目录1. 什么是事务传播行为2. Spring支持的七种事务传播行为2.1 REQUIRED(默认)2.2 SUPPORTS2