JavaWeb：浏览器下载文件时文件名中文乱码解决方案

最新推荐文章于 2025-07-10 16:43:04 发布

lanying100

最新推荐文章于 2025-07-10 16:43:04 发布

阅读量2.9k

点赞数 1

CC 4.0 BY-SA版权

分类专栏：技术文章标签： java

本文链接：https://blog.youkuaiyun.com/lanying100/article/details/107313005

技术专栏收录该内容

33 篇文章

订阅专栏

在JavaWeb项目中，当文件名包含中文字符时，浏览器下载文件可能会出现乱码。问题源自浏览器到服务器再到浏览器的数据传输过程中文件名编码处理不当。解决方法包括修改Tomcat配置文件添加URIEncoding="UTF-8"或在代码中针对不同浏览器采用UTF-8或ISO-8859-1进行文件名编码。提供了一段DownloadUtil.java的代码示例来说明如何判断并处理浏览器类型。

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

问题描述：

JavaWeb项目，实现在浏览器下载服务器端的文件。当文件名包含中文时，浏览器下载下来的文件名称乱码或不显示（只有后缀名）

流程分析：

浏览器 --> 服务器 --> 浏览器

1.浏览器端点击要下载的文件（包含中文字符）

2.服务器获取浏览器传来的参数，并在服务器端查找目标文件，找到后通过IO流写给浏览器端

3.浏览器根据服务器返回的Header信息创建相应文件，此时文件名出现中文乱码现象

解决思路：

1.修改Tomcat 的配置文件

通过超链接（a标签的href属性）访问服务器上的文件，属于GET请求，建议查看Tomcat安装目录下 conf/server.xml 中，是否在两个Connector中添加 URIEncoding="UTF-8"，如下图所示。如此设置之后，浏览器传递给服务器的中文参数应该不是乱码了。

<Connector port="8888" protocol="HTTP/1.1"
               connectionTimeout="20000"
               redirectPort="8443" 
               URIEncoding="UTF-8"
               />

<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" URIEncoding="UTF-8"/>

如果因为一些原因，比如没有权限修改Tomcat的配置文件，那么可以在代码中对文件名转码

filename = new String(filename.getBytes("ISO-8859-1"),"UTF-8"); // 需要捕获异常

2.User-Agent

根据不同的浏览器，对文件名设置不同的编码格式

1）IE、EDGE等微软的浏览器：文件名用UTF-8格式编码

2）其它浏览器：文件名用ISO-8859-1格式编码

判断浏览器的类型：

public class HttpUtils {  
    private static String[] IEBrowserSignals = {"MSIE", "Trident", "Edge"};  
      
    public static boolean isMSBrowser(HttpServletRequest request) {  
        String userAgent = request.getHeader("User-Agent");  
        for (String signal : IEBrowserSignals) {  
            if (userAgent.contains(signal))  
                return true; // 是微软旗下的浏览器
            }  
            return false; // 其它浏览器
        }  
    }  
}

DownloadUtil.java节选代码

response.setContentType("application/octet-stream"); // 二进制流
boolean isMSIE = HttpUtils.isMSBrowser(request); // 判断是否是微软的浏览器
if (isMSIE) {  
    // IE浏览器的乱码问题解决
    fileName = URLEncoder.encode(fileName, "UTF-8");  
} else {  
    // 万能乱码问题解决
    fileName = new String(fileName.getBytes("UTF-8"), "ISO-8859-1");  
}  
// 文件名前后加双引号可以解决firefox浏览器遇到空格时文件名被截断的问题
response.setHeader("Content-disposition", "attachment;filename=\"" + fileName + "\"");

参考网址：

https://blog.youkuaiyun.com/qq_26834541/article/details/82025148

https://blog.youkuaiyun.com/fengchao2016/article/details/55188805