问题描述:

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 + "\"");