JSP 直接輸出 Excel 與 Word 檔案技巧

核心原理

瀏覽器根據 HTTP 回應標頭的 Content-Type 與 Content-Disposition 決定如何處理內容。透過修改 JSP 頁面指令與加入回應標頭，可讓瀏覽器將 HTML 表格內容視為 Excel 或 Word 檔案下載。

實作步驟

1. 修改 page 指令的 contentType

<!-- 輸出 Excel -->
<%@ page contentType="application/vnd.ms-excel;charset=UTF-8" language="java" %>

<!-- 輸出 Word -->
<%@ page contentType="application/vnd.ms-word;charset=UTF-8" language="java" %>

2. 加入 Content-Disposition 標頭觸發下載

放在輸出任何內容之前：

<%
    // Excel
    response.setHeader("Content-Disposition", "attachment;filename=report.xls");
    
    // Word
    response.setHeader("Content-Disposition", "attachment;filename=report.doc");
%>

3. 頁面內容處理原則

• 保留：HTML 表格（<table>）、基本樣式（內嵌 style 屬性）
• 移除：外部 CSS 引用（<link>）、所有 JavaScript/VBScript
• 注意：Excel/Word 開啟 HTML 表格的相容性有限，複雜排版可能錯位

完整範例：匯出會員清單為 Excel

<%@ page contentType="application/vnd.ms-excel;charset=UTF-8" 
    import="java.sql.*,java.util.*" language="java" %>
<%
    response.setHeader("Content-Disposition", "attachment;filename=members_"
        + new java.text.SimpleDateFormat("yyyyMMdd").format(new java.util.Date()) 
        + ".xls");
%>
<html>
<head>
<meta charset="UTF-8">
<style>
    table { border-collapse: collapse; }
    th, td { border: 1px solid #ccc; padding: 4px 8px; }
    th { background-color: #4472C4; color: white; }
</style>
</head>
<body>
<%
    // 資料庫查詢邏輯
    Connection conn = DriverManager.getConnection(...);
    Statement stmt = conn.createStatement();
    ResultSet rs = stmt.executeQuery("SELECT id, name, email, reg_date FROM members ORDER BY id");
%>
<table>
    <tr><th>ID</th><th>姓名</th><th>Email</th><th>註冊日期</th></tr>
    <%
        while (rs.next()) {
    %>
    <tr>
        <td><%=rs.getInt("id")%></td>
        <td><%=rs.getString("name")%></td>
        <td><%=rs.getString("email")%></td>
        <td><%=rs.getString("reg_date")%></td>
    </tr>
    <%
        }
        rs.close(); stmt.close(); conn.close();
    %>
</table>
</body>
</html>

進階議題與限制

中文檔名編碼問題

檔名包含中文時，需處理瀏覽器編碼差異：

String fileName = "會員清單.xls";
String encodedFileName = java.net.URLEncoder.encode(fileName, "UTF-8")
    .replaceAll("\\+", "%20");  // 空格處理
response.setHeader("Content-Disposition", "attachment;filename*=UTF-8''" + encodedFileName);

真正的 Excel 格式（.xlsx）

上述方法產生的是「HTML 偽裝的 .xls」，功能有限。正式專案建議使用 Apache POI 產生真正的二進位 Excel 檔案：

<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>

// Servlet 中產生真正的 .xlsx
Workbook wb = new XSSFWorkbook();
Sheet sheet = wb.createSheet("會員");
Row header = sheet.createRow(0);
header.createCell(0).setCellValue("ID");
header.createCell(1).setCellValue("姓名");
// ... 填入資料
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setHeader("Content-Disposition", "attachment;filename=members.xlsx");
wb.write(response.getOutputStream());

大量資料記憶體問題

POI 的 SXSSFWorkbook 支援串流寫入，適合大量資料匯出。

總結

選擇哪種方式，取決於專案需求與資料規模。快速驗證概念用 HTML 法；正式上線請投資 POI。