java文件下载乱码

### Java 文件下载时出现乱码的解决方案

#### 设置响应头中的字符编码
为了防止文件名在不同浏览器中出现乱码，设置 `Content-Disposition` 头部字段至关重要。对于不同的浏览器，处理方式略有差异：

- 对于IE浏览器，可以采用如下方法来设置头部信息：

  String encodedfileName = URLEncoder.encode(fileName, "UTF-8");
  response.setHeader("Content-Disposition", "attachment;filename=" + encodedfileName);

- 非IE浏览器则推荐使用ISO编码并加上双引号包裹文件名的方式：

  String encodedFileNameForOthers = new String(fileName.getBytes(StandardCharsets.UTF_8), StandardCharsets.ISO_8859_1);
  response.setHeader("Content-disposition", "attachment; filename=\"" + encodedFileNameForOthers + "\"");

上述两种情况均需考虑浏览器类型判断逻辑[^2]。

#### 使用URLEncoder进行URL编码
当文件名为中文或其他非ASCII字符集构成的时候，在构建HTTP请求参数或路径之前应该先对其进行URL编码操作。此过程能够确保特殊字符被正确转义而不至于引起解析失败或者显示异常。具体做法是在发送给客户端前利用 `java.net.URLEncoder` 类来进行转换:

String formFileName = java.net.URLEncoder.encode(originalFileName, "UTF-8").replaceAll("\\+", "%20");
response.setContentType("application/octet-stream;charset=UTF-8");
response.setHeader("content-disposition","attachment;filename="+formFileName+".txt");

这里需要注意的是替换掉所有的加号(`+`)为空格(%20)，因为某些情况下它们会被误解为分隔符而不是实际的空间字符[^4]。

#### 完整示例代码片段展示如何安全地执行文件下载功能而不会造成名称上的混乱
下面给出了一段综合性的例子用于说明怎样在一个Servlet环境中完成带有所述特性的文件流传输服务端编程工作：

import javax.servlet.http.HttpServletResponse;
import java.io.File;
import java.nio.charset.StandardCharsets;

public class FileDownloadService {

    public static void downloadFile(File file, HttpServletResponse response) throws Exception {
        if (!file.exists()) throw new FileNotFoundException();

        // 获取原始文件名
        String originalFilename = file.getName();
        
        // 判断浏览器类型
        boolean isIeOrEdge = ... ;//此处省略获取User-Agent的具体实现
        
        String encodedFileName;
        if (isIeOrEdge){
            encodedFileName = URLEncoder.encode(originalFilename,"UTF-8");
        }else{
            encodedFileName = new String(originalFilename.getBytes(StandardCharsets.UTF_8),
                    StandardCharsets.ISO_8859_1);
        }

        // 设置响应内容类型以及长度
        response.reset();
        response.setContentType("application/octet-stream");
        response.setContentLengthLong(file.length());

        // 添加必要的响应头以指示这是一个附件形式返回的数据包
        response.setHeader("Content-Disposition",
                "attachment; filename=\"" + encodedFileName + "\"");

        try (var inputStream = Files.newInputStream(file.toPath());
             var outputStream = response.getOutputStream()) {

            byte[] buffer = new byte[4096];
            int bytesRead;
            while ((bytesRead = inputStream.read(buffer)) != -1) {
                outputStream.write(buffer, 0, bytesRead);
            }
            outputStream.flush();
        }
    }
}

这段程序展示了完整的从读取本地磁盘上指定位置的目标资源到通过HTTP协议向远端用户提供二进制数据流传送的过程，并且特别注意到了针对各种可能存在的环境因素所采取的不同策略来保障最终呈现效果的一致性和准确性[^3]。