Content-Disposition 文件上传、下载中文乱码 HTTP头解决办法

最新推荐文章于 2025-06-25 00:07:20 发布

VicterTian

最新推荐文章于 2025-06-25 00:07:20 发布

阅读量5.8k

点赞数

CC 4.0 BY-SA版权

分类专栏：平时遇到的问题文章标签：文件上传

本文链接：https://blog.youkuaiyun.com/TTTZZZTTTZZZ/article/details/87015377

平时遇到的问题专栏收录该内容

38 篇文章

订阅专栏

本文详细介绍了在Web应用中，如何解决通过表单上传和下载文件时遇到的中文乱码问题。针对文件上传，前端使用JS对文件名进行encodeURL编码，后端使用URLDecoder.decode解码；对于文件下载，通过设置HTTP响应头Content-Disposition来正确显示中文文件名。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1、文件上传

通过表单上传文件时，如果文件名存在中文则会发生乱码。

<form name="myform" action="/fileManager/uploadFile" method="post" enctype="multipart/form-data"  accept-charset="utf-8" >
   <input type="text" name="path">
   <input type="file" name="file"><br>
   <input type="submit" name="submit" value="submit">
</form>

后端使用Jersey：

@POST
@Path("/uploadFile")
@Consumes(MediaType.MULTIPART_FORM_DATA+";charset=utf-8")
public String uploadFile(
        @FormDataParam("path") String path,
        @FormDataParam("file") InputStream fileInputStream,
        @FormDataParam("file") FormDataContentDisposition fileMetaData);

调用 String fileName=fileMetaData.getFileName();得到的文件名，包含中文时总会乱码。
1.最先想到是没有设置request的编码方式

request.setCharacterEncoding("UTF-8");

设置后依然会乱码

2.Jersey设置Consumer的MediaType

@Consumes(MediaType.MULTIPART_FORM_DATA+";charset=utf-8")

上传的文件名包含中文时，依然会乱码

3.检查form表单和html页面编码，均为UTF-8

后查阅资料解决了该问题：
是由于Content-Disposition请求信息中的编码为ASCII编码，所以需要对请求中的信息进行编码。

1.前端页面通过js编码文件名，encodeURL(filename)
2.后台再Decode就可以得到正确的文件名

String fileName=URLDecoder.decode(fileMetaData.getFileName(),"UTF-8");

2、文件下载

问题：下载文件时，弹出框显示的文件名中文乱码，（在Chrome中正常，在火狐和IE中不能正常显示文件名，或者显示的文件名未解码）

原因：http协议的问题。具体分析见下面的URL

解决办法：添加

 filename*=UTF-8'' + URLEncoder.encode(fileName,"UTF-8")

response.setHeader("Content-Disposition", "attachment;filename*=UTF-8''" + URLEncoder.encode(fileName,"UTF-8"));
response.setContentType("application/octet-stream");
response.setCharacterEncoding("UTF-8");