萬盛學電腦網

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

JSP 中文亂碼完全攻略:頁面編碼、資料庫、URL 參數傳遞三大場景

場景一:JSP 頁面顯示亂碼

原因:未在頁面聲明字元集,容器用預設 ISO-8859-1 讀取/輸出。

解決:頁面頂部雙重聲明:

<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

場景二:資料庫中文亂碼 (MySQL 範例)

JDBC URL 參數:

String url = "jdbc:mysql://localhost/db?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai";

JSP/Servlet 同步設定:

response.setContentType("text/html;charset=UTF-8");
request.setCharacterEncoding("UTF-8"); // 僅對 POST 請求體有效

場景三:URL 參數傳遞亂碼 (GET 請求)

GET 參數在 URL 中經過瀏覽器 URL 編碼,Tomcat 預設以 ISO-8859-1 解碼,導致中文亂碼。

方案一:前端雙重編碼 + 後端手動轉碼 (不推薦,繁瑣)

// 前端 JS
var param = encodeURI(encodeURIComponent("中文參數")); // 雙重編碼
location.href = "b.jsp?name=" + param;

// 後端 JSP/Servlet
String name = request.getParameter("name");
name = new String(name.getBytes("ISO-8859-1"), "UTF-8"); // 手動轉碼

方案二:Tomcat 8+ 統一配置 (推薦)

`server.xml` Connector 加 `URIEncoding="UTF-8"` (見 文章 67859),**後端無需手動轉碼**,`request.getParameter()` 直接得到正確字串。

方案三:Spring 過濾器統一處理 (Spring MVC 最佳實踐)

<!-- web.xml -->
<filter>
    <filter-name>encodingFilter</filter-name>
    <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
    <init-param><param-name>encoding</param-name><param-value>UTF-8</param-value></init-param>
    <init-param><param-name>forceEncoding</param-name><param-value>true</param-value></init-param> <!-- 強制覆蓋 request/response 編碼 -->
</filter>
<filter-mapping><filter-name>encodingFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping>

POST 請求中文亂碼專項

POST 請求體編碼由 `Content-Type: application/x-www-form-urlencoded; charset=...` 決定。瀏覽器通常按頁面編碼發送。

  • **單次請求**:`request.setCharacterEncoding("UTF-8")` **必須在讀取任何參數前調用** (在 Filter 中最早執行)。
  • **Spring MVC**:配置 `CharacterEncodingFilter` + `forceEncoding=true` 即可全局解決。
  • **Multipart (檔案上傳)**:需在 `@MultipartConfig` 或 `MultipartFilter` 中設定編碼。

編碼轉換原理圖解

瀏覽器 (UTF-8 頁面) 
  → 用戶輸入 "中文" 
  → 表單提交 (POST: UTF-8 位元組流 / GET: URL 編碼 %E4%B8%AD%E6%96%87)
  → Tomcat Connector (URIEncoding=UTF-8 解碼 URL; 請求體按 Content-Type charset 或 request.setCharacterEncoding 解碼)
  → ServletRequest 參數 Map (Unicode 字串)
  → 業務邏輯處理 (Java String 內部 UTF-16)
  → 響應輸出 (pageEncoding/contentType=UTF-8 編碼為 UTF-8 位元組流)
  → 瀏覽器以 UTF-8 顯示 "中文"

避坑總結

錯誤做法後果正確做法
只設 `contentType` 不設 `pageEncoding`JSP 檔案讀取錯誤,編譯產生亂碼 .class兩者同時設,且與檔案實際存檔編碼一致
GET 參數後端手動 `getBytes("ISO-8859-1")` 轉碼Tomcat 8+ 已正確解碼,再轉反而亂碼配置 `URIEncoding="UTF-8"`,後端直接用
`request.setCharacterEncoding()` 寫在讀取參數之後無效,請求體已解析完畢放在 Filter 最開頭 / Servlet `service()` 首行
資料庫連線未設 `characterEncoding`存入/讀出中文亂碼JDBC URL 明確指定
檔案上傳中文檔名亂碼瀏覽器編碼不一 (IE GBK, Chrome UTF-8)用 `FileUpload` 並指定 `setHeaderEncoding("UTF-8")` 或 Servlet 3.0 標準 API
copyright © 萬盛學電腦網 all rights reserved