JSP/Servlet 訪問提示下載而非執行：MIME 類型配置錯誤排查

瀏覽器訪問 JSP 或 Servlet 卻彈出下載對話框，而非渲染頁面，核心原因是響應 Content-Type 設置錯誤或缺失，導致瀏覽器無法識別為 HTML 文檔。本文給出 JSP 與 Servlet 兩種場景的標準修正代碼。

現象與根因

• 瀏覽器依賴 HTTP 響應頭 Content-Type 判斷內容類型
• 缺失或錯誤的 Content-Type 會導致瀏覽器按二進制流處理，觸發下載
• 不同瀏覽器容錯行為不一，故「有的瀏覽器正常、有的異常」

JSP 頁面修正

在頁面最頂端（任何輸出前）添加 page 指令：

<%@ page contentType="text/html;charset=UTF-8" %>

• text/html 告知瀏覽器為 HTML 文檔
• charset=UTF-8 指定字符編碼，同時解決中文顯示問題
• 建議統一使用 UTF-8，避免 GB2312/GBK 兼容性問題

Servlet 修正

在輸出內容前（獲取 Writer/OutputStream 前）設置：

response.setContentType("text/html;charset=UTF-8");

或分兩步：

response.setCharacterEncoding("UTF-8");
response.setContentType("text/html");

常見誤區

1. 寫在輸出代碼之後：響應頭已提交，設置無效
2. 拼寫錯誤：如 text/html; charset=gb2312 缺少引號、分號位置錯誤
3. 僅設置 charset 未設置 media type：response.setCharacterEncoding("UTF-8") 不會自動添加 text/html

最佳實踐

• JSP：統一在頁面第一行聲明 contentType="text/html;charset=UTF-8" 及 pageEncoding="UTF-8"
• Servlet：基類或過濾器統一設置 response.setContentType("text/html;charset=UTF-8")
• 靜態資源：依賴 Web 容器預設 MIME 映射，確保 web.xml mime-mapping 正確

驗證方法

瀏覽器開發者工具 Network 面板查看響應頭：
Content-Type: text/html;charset=UTF-8 → 正確渲染
Content-Type: application/octet-stream 或無 → 觸發下載

正確設置 MIME 類型，是 Web 應用正常運行的基礎配置之一。