Servlet 原生 Response 实现文件下载

Servlet 核心实现

接下来看核心的 Java 代码。这里用到了 ServletOutputStream 将文件字节流写入响应体，并通过设置 Header 告诉浏览器以附件形式打开。

package com.xiangshuai.servlet;

import java.io.BufferedInputStream;
import java.io.BufferedOutputStream;
import java.io.File;
import java.io.FileInputStream;
import java.io.IOException;
import java.io.UnsupportedEncodingException;
import java.net.URLEncoder;

import javax.servlet.ServletException;
import javax.servlet.ServletOutputStream;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class DownloadServlet extends HttpServlet {

    private static final long serialVersionUID = 1L;

    @Override
    protected void doGet(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        
        BufferedInputStream bis = null;
        BufferedOutputStream bos = null;
        
        // 生产环境建议从配置文件或环境变量读取，避免硬编码路径
        String con = "F:/download"; 
        String filename = request.getParameter("filename");
        
        // 设置请求和响应的字符编码，防止中文乱码
        request.setCharacterEncoding("utf-8");
        response.setCharacterEncoding("UTF-8");
        
        // 关键：Content-Disposition 头信息
        // attachment 表示强制下载，inline 表示尝试在浏览器内打开
        // filename 参数指定下载后的文件名，中文需进行 URL 编码
        try {
            String encodedFilename = URLEncoder.encode(filename, "UTF-8");
            response.setHeader("Content-Disposition", "attachment;filename=" + encodedFilename);
        } catch (UnsupportedEncodingException e) {
            e.printStackTrace();
        }

        ServletOutputStream os = response.getOutputStream();

        try {
            // 构建文件对象并创建输入流
            File file = new File(con + "/" + filename);
            if (!file.exists()) {
                throw new IOException("File not found: " + filename);
            }
            bis = new BufferedInputStream(new FileInputStream(file));
            bos = new BufferedOutputStream(os);

            byte[] b = new byte[1024];
            int len = -1;
            while ((len = bis.read(b)) != -1) {
                bos.write(b, 0, len);
                bos.flush();
            }
        } catch (Exception e) {
            e.printStackTrace();
        } finally {
            // IO 流必须关闭，否则可能导致连接池耗尽或内存泄漏
            if (bos != null) {
                try { bos.close(); } catch (IOException e) { e.printStackTrace(); }
            }
            if (bis != null) {
                try { bis.close(); } catch (IOException e) { e.printStackTrace(); }
            }
        }
    }

    @Override
    protected void doPost(HttpServletRequest request, HttpServletResponse response)
            throws ServletException, IOException {
        doGet(request, response);
    }
}

关键点解析

1. Content-Disposition 的作用

这个响应头是控制浏览器行为的关键。当设置为 attachment 时，浏览器会弹出保存对话框而不是直接在窗口渲染内容。如果类型是图片但设置了这个头，浏览器也会提示下载而不是显示图片。

2. 中文文件名处理

代码中使用了 URLEncoder.encode 对文件名进行了编码。如果不处理，包含中文的文件名在某些浏览器下会变成乱码（如 %E7%BE%8E...），导致下载后无法识别。虽然现代浏览器兼容性好了很多，但在企业级应用中加上这一步更稳妥。

3. 资源清理

IO 流操作最忌讳的就是忘记关闭。我们在 finally 块中检查流是否为空并执行 close()。这不仅能释放系统资源，还能确保缓冲区数据被彻底刷新到客户端。

4. 路径问题

示例中写死了 F:/download，这在 Windows 上没问题，但换到 Linux 服务器就会报错。实际项目中建议使用 ServletContext.getRealPath("/upload") 或者配置类注入的路径常量，保证跨平台兼容性。

通过这种方式，我们不仅实现了文件下载，还预留了后续添加权限验证、流量统计等扩展功能的入口。