Java Web 文件下载功能实现全解析：从超链接到 Servlet 实战

Java Web 文件下载的两种核心实现方式

在 Java Web 开发中，文件下载是常见需求。本文通过实例详细讲解两种主流实现方案：简单的超链接下载与更可控的 Servlet 流式下载，并分析浏览器对不同文件类型的处理差异。

方案一：超链接直接下载

最直观的方式是使用 HTML <a> 标签直接指向文件路径：

<a href="/day06/download/cors.zip">压缩包</a>
<a href="/day06/download/1.png">图片</a>

这种方式无需后端代码，但存在明显缺陷：浏览器能识别的文件类型（如图片、PDF、TXT）会直接在浏览器中打开，而非触发下载；只有无法识别的类型（如 ZIP、RAR）才会弹出下载对话框。这导致用户体验不一致。

方案二：Servlet 流式下载（推荐）

通过 Servlet 读取文件流并设置响应头，可强制所有文件以附件形式下载，完美解决上述问题。

核心步骤：

1. 前端请求：链接携带文件名参数指向 Servlet
   <a href="/day06/ServletDownload?filename=cors.zip">压缩包</a>
2. Servlet 处理：
   • 获取请求参数 filename
   • 设置 Content-Type 为文件 MIME 类型
   • 关键设置 Content-Disposition: attachment;filename=xxx 强制下载
   • 通过 ServletContext.getRealPath() 获取服务器绝对路径
   • 使用 FileInputStream 读取文件，response.getOutputStream() 写入响应

完整 Servlet 代码示例：

@WebServlet("/ServletDownload")
public class ServletDownload extends HttpServlet {
    protected void doGet(HttpServletRequest request, HttpServletResponse response) 
            throws ServletException, IOException {
        String filename = request.getParameter("filename");
        // 设置响应头
        response.setContentType(getServletContext().getMimeType(filename));
        response.setHeader("Content-Disposition", "attachment;filename=" + filename);
        
        // 读取文件并输出
        String fullPath = getServletContext().getRealPath("/download/" + filename);
        try (InputStream in = new FileInputStream(fullPath);
             OutputStream out = response.getOutputStream()) {
            byte[] buffer = new byte[1024];
            int len;
            while ((len = in.read(buffer)) > 0) {
                out.write(buffer, 0, len);
            }
        }
    }
}

进阶技巧：通用下载工具类

实际项目中常封装工具类处理编码、大文件分块传输、断点续传等场景。关键点包括：

• 文件名编码处理：new String(filename.getBytes("UTF-8"), "ISO-8859-1") 解决中文乱码
• 设置 Content-Length 支持下载进度显示
• 使用 BufferedInputStream/OutputStream 提升大文件传输性能
• 注意：必须通过超链接或 window.location.href 发起请求，AJAX 无法直接处理文件流下载

总结

超链接下载适合简单静态资源，Servlet 流式下载提供完全控制，是企业级应用的标准做法。理解浏览器 MIME 类型识别机制与 Content-Disposition 头的作用，是掌握文件下载的关键。