Java 怎么解决文件上传时中文文件名变成问号乱码

浅婷酱_2040

浅婷酱_2040

2026-09-15

215人浏览

原创

Java文件上传中文名变问号本质是服务端用ISO-8859-1错误解析UTF-8编码的filename参数;需前端正确编码、后端先按ISO-8859-1获取字节再用UTF-8重构文件名,同时配置CharacterEncodingFilter和Tomcat URIEncoding为UTF-8。

java 怎么解决文件上传时中文文件名变成问号乱码

Java 文件上传时中文文件名变成问号(如 ???.pdf),本质是服务器端用 ISO-8859-1 解析了本应是 UTF-8 编码的文件名,导致字节被错误映射为不可见字符。核心不是“文件内容乱码”,而是 HTTP 头中 filename 参数的解码失败。解决需分两步:确保前端正确编码、后端正确解码。

确认并统一请求编码(服务端入口)

无论使用 Spring MVC、Servlet 还是 Apache Commons FileUpload,第一步必须让容器能正确读取原始请求体:

  • 在 web.xml 中配置 CharacterEncodingFilter,filter 必须放在所有其他 filter 之前,且 encoding 显式设为 UTF-8
  • 若用 Tomcat,检查 server.xml 中 Connector 是否设置了 URIEncoding="UTF-8"(影响 GET,但部分旧版 multipart 实现也会间接依赖)
  • Spring Boot 项目,在 application.properties 加:
    server.servlet.encoding.charset=UTF-8
    server.servlet.encoding.force=true

正确解析 multipart 中的中文文件名(关键步骤)

标准 Servlet API(如 Part.getSubmittedFileName())或 Commons FileUpload 的 FileItem.getName() 返回的字符串,**在未做任何干预时,已按 ISO-8859-1 解码过一次**。此时直接用它,等于把 UTF-8 字节流当 ISO-8859-1 解,必然出错。正确做法是“反向还原”:

Java基础版
Java基础版

编写健壮 Java 代码的基础能力,覆盖空指针防护、相等性判断与基础异常处理。

下载
  • 获取原始字节数组:String rawName = part.getSubmittedFileName(); byte[] bytes = rawName.getBytes(StandardCharsets.ISO_8859_1);
  • 再以 UTF-8 重新构造:String fileName = new String(bytes, StandardCharsets.UTF_8);
  • Spring MVC 用户注意:@RequestParam MultipartFile 的 getOriginalFilename() 默认已尝试修复,但依赖容器配置;保险起见仍建议手动转码

避免常见陷阱

以下操作反而会加重问题,务必避开:

  • 对已解码的字符串再执行 new String(name.getBytes("UTF-8"), "ISO-8859-1") —— 这是典型双解码,会导致二次乱码
  • 在 Nginx 或反向代理层未设置 charset utf-8;,导致 header 被截断或重编码
  • 前端用 FormData.append('file', file) 时,未确保页面本身是 UTF-8()
  • 使用老版本 commons-fileupload(

补充:兼容老旧浏览器的下载头写法(顺带验证)

如果上传后还要提供下载,且需兼容 IE,可参考 Content-Disposition 的双格式写法,这反过来也印证了文件名编码逻辑:

  • 现代浏览器:Content-Disposition: attachment; filename*=UTF-8''%E4%BD%A0%E5%A5%BD.txt
  • IE 兼容:Content-Disposition: attachment; filename="你好.txt"(HTML 实体)或 filename="youhao.txt"(ASCII 文件名)

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12877

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9962

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8452

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1344

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1616

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3369

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20591

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1455

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习