瀏覽器訪問 `.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 前調用 |
| Servlet | response.setContentType("text/html"); response.setCharacterEncoding("UTF-8"); | 合寫為一行 | 分開寫可能被容器覆蓋,建議合寫 |
| 靜態資源 | web.xml 缺少 mime-mapping | 添加 <mime-mapping> | css/js/png 等靜態文件依賴容器默認映射 |
<%@ page language="java" contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
@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);
}
}
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());
response.setContentType("application/json;charset=UTF-8");
response.getWriter().write(jsonString);
response.setContentType("image/jpeg"); // 或 image/png, image/gif
response.setHeader("Cache-Control", "max-age=3600");
ImageIO.write(image, "JPEG", response.getOutputStream());
response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet");
response.setHeader("Content-Disposition", "attachment; filename*=UTF-8''export.xlsx");
workbook.write(response.getOutputStream());
<!-- 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` 覆蓋/補充。
#!/bin/bash
# 檢查項目中缺少 page 指令或 contentType 不含 charset 的 JSP
find . -name "*.jsp" -exec grep -L "contentType.*charset" {} \;