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

相关文章

springboot3.x使用@NacosValue无法获取配置信息的解决过程

《springboot3.x使用@NacosValue无法获取配置信息的解决过程》在SpringBoot3.x中升级Nacos依赖后,使用@NacosValue无法动态获取配置,通过引入SpringC... 目录一、python问题描述二、解决方案总结一、问题描述springboot从2android.x

SpringBoot整合AOP及使用案例实战

《SpringBoot整合AOP及使用案例实战》本文详细介绍了SpringAOP中的切入点表达式,重点讲解了execution表达式的语法和用法,通过案例实战,展示了AOP的基本使用、结合自定义注解以... 目录一、 引入依赖二、切入点表达式详解三、案例实战1. AOP基本使用2. AOP结合自定义注解3.

Java实现字符串大小写转换的常用方法

《Java实现字符串大小写转换的常用方法》在Java中,字符串大小写转换是文本处理的核心操作之一,Java提供了多种灵活的方式来实现大小写转换,适用于不同场景和需求,本文将全面解析大小写转换的各种方法... 目录前言核心转换方法1.String类的基础方法2. 考虑区域设置的转换3. 字符级别的转换高级转换

MySQL数据目录迁移的完整过程

《MySQL数据目录迁移的完整过程》文章详细介绍了将MySQL数据目录迁移到新硬盘的整个过程,包括新硬盘挂载、创建新的数据目录、迁移数据(推荐使用两遍rsync方案)、修改MySQL配置文件和重启验证... 目录1,新硬盘挂载(如果有的话)2,创建新的 mysql 数据目录3,迁移 MySQL 数据(推荐两

input的accept属性让文件上传安全高效

《input的accept属性让文件上传安全高效》文章介绍了HTML的input文件上传`accept`属性在文件上传校验中的重要性和优势,通过使用`accept`属性,可以减少前端JavaScrip... 目录前言那个悄悄毁掉你上传体验的“常见写法”改变一切的 html 小特性:accept真正的魔法:让

MyBatis-Plus逻辑删除实现过程

《MyBatis-Plus逻辑删除实现过程》本文介绍了MyBatis-Plus如何实现逻辑删除功能,包括自动填充字段、配置与实现步骤、常见应用场景,并展示了如何使用remove方法进行逻辑删除,逻辑删... 目录1. 逻辑删除的必要性编程1.1 逻辑删除的定义1.2 逻辑删php除的优点1.3 适用场景2.

SpringBoot简单整合ElasticSearch实践

《SpringBoot简单整合ElasticSearch实践》Elasticsearch支持结构化和非结构化数据检索,通过索引创建和倒排索引文档,提高搜索效率,它基于Lucene封装,分为索引库、类型... 目录一:ElasticSearch支持对结构化和非结构化的数据进行检索二:ES的核心概念Index:

Java方法重载与重写之同名方法的双面魔法(最新整理)

《Java方法重载与重写之同名方法的双面魔法(最新整理)》文章介绍了Java中的方法重载Overloading和方法重写Overriding的区别联系,方法重载是指在同一个类中,允许存在多个方法名相同... 目录Java方法重载与重写:同名方法的双面魔法方法重载(Overloading):同门师兄弟的不同绝

Spring配置扩展之JavaConfig的使用小结

《Spring配置扩展之JavaConfig的使用小结》JavaConfig是Spring框架中基于纯Java代码的配置方式,用于替代传统的XML配置,通过注解(如@Bean)定义Spring容器的组... 目录JavaConfig 的概念什么是JavaConfig?为什么使用 JavaConfig?Jav

Java数组动态扩容的实现示例

《Java数组动态扩容的实现示例》本文主要介绍了Java数组动态扩容的实现示例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧... 目录1 问题2 方法3 结语1 问题实现动态的给数组添加元素效果,实现对数组扩容,原始数组使用静态分配