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

相关文章

Java实现删除文件中的指定内容

《Java实现删除文件中的指定内容》在日常开发中,经常需要对文本文件进行批量处理,其中,删除文件中指定内容是最常见的需求之一,下面我们就来看看如何使用java实现删除文件中的指定内容吧... 目录1. 项目背景详细介绍2. 项目需求详细介绍2.1 功能需求2.2 非功能需求3. 相关技术详细介绍3.1 Ja

springboot项目中整合高德地图的实践

《springboot项目中整合高德地图的实践》:本文主要介绍springboot项目中整合高德地图的实践,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教... 目录一:高德开放平台的使用二:创建数据库(我是用的是mysql)三:Springboot所需的依赖(根据你的需求再

spring中的ImportSelector接口示例详解

《spring中的ImportSelector接口示例详解》Spring的ImportSelector接口用于动态选择配置类,实现条件化和模块化配置,关键方法selectImports根据注解信息返回... 目录一、核心作用二、关键方法三、扩展功能四、使用示例五、工作原理六、应用场景七、自定义实现Impor

SpringBoot3应用中集成和使用Spring Retry的实践记录

《SpringBoot3应用中集成和使用SpringRetry的实践记录》SpringRetry为SpringBoot3提供重试机制,支持注解和编程式两种方式,可配置重试策略与监听器,适用于临时性故... 目录1. 简介2. 环境准备3. 使用方式3.1 注解方式 基础使用自定义重试策略失败恢复机制注意事项

SpringBoot整合Flowable实现工作流的详细流程

《SpringBoot整合Flowable实现工作流的详细流程》Flowable是一个使用Java编写的轻量级业务流程引擎,Flowable流程引擎可用于部署BPMN2.0流程定义,创建这些流程定义的... 目录1、流程引擎介绍2、创建项目3、画流程图4、开发接口4.1 Java 类梳理4.2 查看流程图4

qt5cored.dll报错怎么解决? 电脑qt5cored.dll文件丢失修复技巧

《qt5cored.dll报错怎么解决?电脑qt5cored.dll文件丢失修复技巧》在进行软件安装或运行程序时,有时会遇到由于找不到qt5core.dll,无法继续执行代码,这个问题可能是由于该文... 遇到qt5cored.dll文件错误时,可能会导致基于 Qt 开发的应用程序无法正常运行或启动。这种错

一文详解如何在idea中快速搭建一个Spring Boot项目

《一文详解如何在idea中快速搭建一个SpringBoot项目》IntelliJIDEA作为Java开发者的‌首选IDE‌,深度集成SpringBoot支持,可一键生成项目骨架、智能配置依赖,这篇文... 目录前言1、创建项目名称2、勾选需要的依赖3、在setting中检查maven4、编写数据源5、开启热

Java对异常的认识与异常的处理小结

《Java对异常的认识与异常的处理小结》Java程序在运行时可能出现的错误或非正常情况称为异常,下面给大家介绍Java对异常的认识与异常的处理,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参... 目录一、认识异常与异常类型。二、异常的处理三、总结 一、认识异常与异常类型。(1)简单定义-什么是

SpringBoot项目配置logback-spring.xml屏蔽特定路径的日志

《SpringBoot项目配置logback-spring.xml屏蔽特定路径的日志》在SpringBoot项目中,使用logback-spring.xml配置屏蔽特定路径的日志有两种常用方式,文中的... 目录方案一:基础配置(直接关闭目标路径日志)方案二:结合 Spring Profile 按环境屏蔽关

Java使用HttpClient实现图片下载与本地保存功能

《Java使用HttpClient实现图片下载与本地保存功能》在当今数字化时代,网络资源的获取与处理已成为软件开发中的常见需求,其中,图片作为网络上最常见的资源之一,其下载与保存功能在许多应用场景中都... 目录引言一、Apache HttpClient简介二、技术栈与环境准备三、实现图片下载与保存功能1.