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集成/输出/日志级别控制/持久化开发实践

《SpringBoot集成/输出/日志级别控制/持久化开发实践》SpringBoot默认集成Logback,支持灵活日志级别配置(INFO/DEBUG等),输出包含时间戳、级别、类名等信息,并可通过... 目录一、日志概述1.1、Spring Boot日志简介1.2、日志框架与默认配置1.3、日志的核心作用

破茧 JDBC:MyBatis 在 Spring Boot 中的轻量实践指南

《破茧JDBC:MyBatis在SpringBoot中的轻量实践指南》MyBatis是持久层框架,简化JDBC开发,通过接口+XML/注解实现数据访问,动态代理生成实现类,支持增删改查及参数... 目录一、什么是 MyBATis二、 MyBatis 入门2.1、创建项目2.2、配置数据库连接字符串2.3、入

Springboot项目启动失败提示找不到dao类的解决

《Springboot项目启动失败提示找不到dao类的解决》SpringBoot启动失败,因ProductServiceImpl未正确注入ProductDao,原因:Dao未注册为Bean,解决:在启... 目录错误描述原因解决方法总结***************************APPLICA编

深度解析Spring Security 中的 SecurityFilterChain核心功能

《深度解析SpringSecurity中的SecurityFilterChain核心功能》SecurityFilterChain通过组件化配置、类型安全路径匹配、多链协同三大特性,重构了Spri... 目录Spring Security 中的SecurityFilterChain深度解析一、Security

SpringBoot多环境配置数据读取方式

《SpringBoot多环境配置数据读取方式》SpringBoot通过环境隔离机制,支持properties/yaml/yml多格式配置,结合@Value、Environment和@Configura... 目录一、多环境配置的核心思路二、3种配置文件格式详解2.1 properties格式(传统格式)1.

Apache Ignite 与 Spring Boot 集成详细指南

《ApacheIgnite与SpringBoot集成详细指南》ApacheIgnite官方指南详解如何通过SpringBootStarter扩展实现自动配置,支持厚/轻客户端模式,简化Ign... 目录 一、背景:为什么需要这个集成? 二、两种集成方式(对应两种客户端模型) 三、方式一:自动配置 Thick

Python实现网格交易策略的过程

《Python实现网格交易策略的过程》本文讲解Python网格交易策略,利用ccxt获取加密货币数据及backtrader回测,通过设定网格节点,低买高卖获利,适合震荡行情,下面跟我一起看看我们的第一... 网格交易是一种经典的量化交易策略,其核心思想是在价格上下预设多个“网格”,当价格触发特定网格时执行买

解决pandas无法读取csv文件数据的问题

《解决pandas无法读取csv文件数据的问题》本文讲述作者用Pandas读取CSV文件时因参数设置不当导致数据错位,通过调整delimiter和on_bad_lines参数最终解决问题,并强调正确参... 目录一、前言二、问题复现1. 问题2. 通过 on_bad_lines=‘warn’ 跳过异常数据3

Spring WebClient从入门到精通

《SpringWebClient从入门到精通》本文详解SpringWebClient非阻塞响应式特性及优势,涵盖核心API、实战应用与性能优化,对比RestTemplate,为微服务通信提供高效解决... 目录一、WebClient 概述1.1 为什么选择 WebClient?1.2 WebClient 与

Java.lang.InterruptedException被中止异常的原因及解决方案

《Java.lang.InterruptedException被中止异常的原因及解决方案》Java.lang.InterruptedException是线程被中断时抛出的异常,用于协作停止执行,常见于... 目录报错问题报错原因解决方法Java.lang.InterruptedException 是 Jav