Java 文件下載兩大實現：原生 Servlet 與 Spring MVC 最佳實踐

Java 文件下載兩大實現：原生 Servlet 與 Spring MVC 最佳實踐

一、 原生 Servlet 二進制流下載

public void download(HttpServletRequest request, HttpServletResponse response) throws IOException {
    String filePath = request.getSession().getServletContext().getRealPath("/apk/android/NCB.apk");
    File file = new File(filePath);
    if (!file.exists()) return;

    String fileName = URLEncoder.encode(file.getName(), "UTF-8");
    response.reset();
    response.setContentType(request.getServletContext().getMimeType(fileName));
    response.addHeader("Content-Disposition", "attachment; filename=" + fileName);
    response.setContentLength((int) file.length());

    try (InputStream in = new FileInputStream(file);
         ServletOutputStream out = response.getOutputStream()) {
        byte[] buf = new byte[4096];
        int len;
        while ((len = in.read(buf)) != -1) {
            out.write(buf, 0, len);
        }
    }
}

二、 Spring MVC + Commons IO 精簡版

public void downloadTemplate(HttpServletRequest request, HttpServletResponse response) {
    String path = request.getSession().getServletContext().getRealPath("");
    File file = new File(path + "\\file\\template\\模板文件.xls");

    String userAgent = request.getHeader("User-Agent");
    byte[] bytes = userAgent.contains("MSIE") ? file.getName().getBytes() : file.getName().getBytes("UTF-8");
    String fileName = new String(bytes, "ISO-8859-1");

    response.setContentType("multipart/form-data");
    response.setHeader("Content-Disposition", "attachment;fileName=" + URLEncoder.encode(fileName, "UTF-8"));

    try (InputStream in = new FileInputStream(file)) {
        IOUtils.copy(in, response.getOutputStream());
    } catch (IOException e) {
        e.printStackTrace();
    }
}

三、 關鍵點對比

四、 通用最佳實踐

• 設置 Content-Disposition: attachment; filename=... 強制瀏覽器下載而非預覽。
• 設置 Content-Length 支援下載進度條。
• 大文件建議啟用 BufferedInputStream/OutputStream 或 NIO FileChannel.transferTo 零拷貝。
• 生產環境加入範圍請求（Range）支援斷點續傳。

Spring MVC 專案首選 IOUtils.copy 方案，代碼少、異常安全、中文文件名兼容性好；非 Spring 環境參考原生寫法並補全資源釋放邏輯。