萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> JSP 程式設計

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

現象描述

瀏覽器訪問 `.jsp` 或 Servlet 映射路徑,彈出文件下載對話框,而非渲染頁面。原因:**響應 Header `Content-Type` 缺失或錯誤**,導致瀏覽器按二進制流處理 (默認 `application/octet-stream`)。

根因分析

場景錯誤代碼正確代碼說明
JSP 頁面<%@ page contentType="text/html" %> (缺 charset)<%@ page contentType="text/html;charset=UTF-8" %>page 指令 contentType 必須包含 charset
JSP 頁面無 page 指令,容器默認添加 page 指令容器默認可能為 text/plain 或無 charset
Servlet無設置 / 設置錯誤response.setContentType("text/html;charset=UTF-8");必須在獲取 Writer/Stream 前調用
Servletresponse.setContentType("text/html"); response.setCharacterEncoding("UTF-8");合寫為一行分開寫可能被容器覆蓋,建議合寫
靜態資源web.xml 缺少 mime-mapping添加 <mime-mapping>css/js/png 等靜態文件依賴容器默認映射

標準解決方案

JSP 頁面 (頁面頂部第一行)

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

Servlet (service/doGet/doPost 方法首行)

@Override
protected void doGet(HttpServletRequest request, HttpServletResponse response) 
        throws ServletException, IOException {
    // 必須在 response.getWriter() / getOutputStream() 之前
    response.setContentType("text/html;charset=UTF-8");
    // 後續邏輯...
}

全局過濾器統一設置 (推薦)

@WebFilter("/*")
public class ContentTypeFilter implements Filter {
    @Override
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
        HttpServletResponse response = (HttpServletResponse) resp;
        // 設置默認 Content-Type,若後續代碼已設置則不覆蓋
        if (response.getContentType() == null) {
            response.setContentType("text/html;charset=UTF-8");
        }
        chain.doFilter(req, resp);
    }
}

特殊場景處理

1. 文件下載 (故意觸發下載)

response.setContentType("application/octet-stream");
response.setHeader("Content-Disposition", "attachment; filename*=UTF-8''" + 
    URLEncoder.encode(fileName, "UTF-8").replaceAll("\\+", "%20"));
response.setHeader("Content-Length", String.valueOf(fileLength));
Files.copy(filePath, response.getOutputStream());

2. JSON API 接口

response.setContentType("application/json;charset=UTF-8");
response.getWriter().write(jsonString);

3. 圖片/二進制流

response.setContentType("image/jpeg"); // 或 image/png, image/gif
response.setHeader("Cache-Control", "max-age=3600");
ImageIO.write(image, "JPEG", response.getOutputStream());

4. Excel 導出 (POI)

response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setHeader("Content-Disposition", "attachment; filename*=UTF-8''export.xlsx");
workbook.write(response.getOutputStream());

容器級默認 MIME 映射 (web.xml / server.xml)

<!-- web.xml 標準配置 -->
<mime-mapping>
    <extension>css</extension>
    <mime-type>text/css</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>js</extension>
    <mime-type>application/javascript</mime-type>
</mime-mapping>
<mime-mapping>
    <extension>woff2</extension>
    <mime-type>font/woff2</mime-type>
</mime-mapping>
<!-- 更多擴展名... -->

Tomcat `conf/web.xml` 已內置常見映射,自定義類型可在項目 `web.xml` 覆蓋/補充。

排查檢查清單

  1. ✅ JSP 頁面第一行是否有 `page` 指令且 `contentType` 包含 `charset`
  2. ✅ Servlet 是否在寫入響應前調用 `setContentType()`
  3. ✅ 是否有 Filter/攔截器誤清除/覆蓋了 Content-Type
  4. ✅ 響應是否已提交 (`response.isCommitted()`) 後嘗試修改 Header
  5. ✅ 瀏覽器開發者工具 Network 面板查看實際響應 Header
  6. ✅ 靜態資源 404 導致錯誤頁面無 Content-Type (配置錯誤頁面)

一鍵修復腳本 (Linux 批量檢查 JSP)

#!/bin/bash
# 檢查項目中缺少 page 指令或 contentType 不含 charset 的 JSP
find . -name "*.jsp" -exec grep -L "contentType.*charset" {} \;
copyright © 萬盛學電腦網 all rights reserved