Java下载文件时文件名乱码问题解决办法

关于Java下载文件时出现文件名乱码问题的解决办法，我将提供以下完整攻略：

问题描述

当我们使用Java程序进行文件下载时，有时会出现文件名乱码的问题。这是因为在Http响应头中，如果文件名中含有中文等非英文字符，服务器会使用UTF-8对文件名进行编码，而Java程序默认使用ISO-8859-1来解码文件名，因此就会出现乱码问题。

解决办法

1.获取文件名编码字符集

可以通过获取Http响应头中“Content-Disposition”字段的值来获取文件名编码字符集。如下代码示例：

URL url = new URL(fileUrl);
HttpURLConnection conn = (HttpURLConnection) url.openConnection();
conn.setRequestMethod("GET");
InputStream inputStream = conn.getInputStream();
String contentDis = conn.getHeaderField("Content-Disposition");
String charset = "ISO-8859-1"; // 默认编码字符集
if (contentDis != null && contentDis.contains("filename=")) {
    String[] tmp = contentDis.split("filename=");
    if (tmp.length > 1) {
        String fileName = tmp[1].replaceAll("\"", "");
        fileName = URLDecoder.decode(fileName, "UTF-8");
        charset = new String(fileName.getBytes("ISO-8859-1"), "UTF-8");
    }
}

2.设置正确的编码字符集

在获取到文件名编码字符集后，就可以将Java程序的编码字符集设置为正确的编码字符集。如下代码示例：

String userAgent = request.getHeader("User-Agent");
String fileName = URLEncoder.encode(file.getName(), charset);
if (userAgent.contains("MSIE") || userAgent.contains("Trident")) {
    fileName = java.net.URLEncoder.encode(file.getName(), charset);
}
response.setContentType("application/octet-stream");
response.setHeader("Content-Disposition", String.format("attachment;filename=\"%s\"", fileName));
InputStream inputStream = new BufferedInputStream(new FileInputStream(file));
OutputStream outputStream = response.getOutputStream();
byte[] buffer = new byte[1024];
int length = 0;
while ((length = inputStream.read(buffer)) != -1) {
    outputStream.write(buffer, 0, length);
}
outputStream.flush();

这里需要注意的是，在设置Http响应头“Content-Disposition”字段的值时，需要使用正确的编码字符集进行编码，否则下载下来的文件名仍然会是乱码。

示例

假设有一个文件下载的请求，请求路径为“http://www.example.com/download?fileId=1”，Java程序需要从该链接下载指定的文件，并将文件名以附件形式返回给用户进行下载，那么具体的实现如下所示：

@RequestMapping(value = "/download", produces = "application/json;charset=UTF-8")
@ResponseBody
public String downloadFile(@RequestParam("fileId") Integer fileId, HttpServletRequest request,
    HttpServletResponse response) {
    File file = getFileById(fileId); // 根据文件id获取文件对象
    if (!file.exists()) { // 如果文件不存在，则返回文件不存在的错误信息
        return "{'success':false,'msg':'File not existed!'}";
    }
    try {
        URL url = new URL("http://www.example.com/download?fileId=" + fileId);
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();
        conn.setRequestMethod("GET");
        InputStream inputStream = conn.getInputStream();
        String contentDis = conn.getHeaderField("Content-Disposition");
        String charset = "ISO-8859-1";
        if (contentDis != null && contentDis.contains("filename=")) {
            String[] tmp = contentDis.split("filename=");
            if (tmp.length > 1) {
                String fileName = tmp[1].replaceAll("\"", "");
                fileName = URLDecoder.decode(fileName, "UTF-8");
                charset = new String(fileName.getBytes("ISO-8859-1"), "UTF-8");
            }
        }
        String userAgent = request.getHeader("User-Agent");
        String fileName = URLEncoder.encode(file.getName(), charset);
        if (userAgent.contains("MSIE") || userAgent.contains("Trident")) {
            fileName = java.net.URLEncoder.encode(file.getName(), charset);
        }
        response.setContentType("application/octet-stream");
        response.setHeader("Content-Disposition", String.format("attachment;filename=\"%s\"", fileName));
        InputStream inputStream = new BufferedInputStream(new FileInputStream(file));
        OutputStream outputStream = response.getOutputStream();
        byte[] buffer = new byte[1024];
        int length = 0;
        while ((length = inputStream.read(buffer)) != -1) {
            outputStream.write(buffer, 0, length);
        }
        outputStream.flush();
        outputStream.close();
        inputStream.close();
    } catch (IOException e) { // 如果下载过程中发生异常，则返回下载失败的错误信息
        e.printStackTrace();
        return "{'success':false,'msg':'Download failed!'}";
    }
    return "{'success':true,'msg':'Download successfully!'}";
}

在上述示例中，“getFileById()”方法用于根据文件id获取文件对象，具体实现可以根据业务需要自行编写。另外需要注意的是，需要将请求头中的“User-Agent”字段用作判断浏览器类型的标志来对文件名进行编码，这是因为不同浏览器对于文件名编码和解码方式是有所不同的。