原因:未在頁面聲明字元集,容器用預設 ISO-8859-1 讀取/輸出。
解決:頁面頂部雙重聲明:
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
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 請求體有效
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"); // 手動轉碼
`server.xml` Connector 加 `URIEncoding="UTF-8"` (見 文章 67859),**後端無需手動轉碼**,`request.getParameter()` 直接得到正確字串。
<!-- 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 請求體編碼由 `Content-Type: application/x-www-form-urlencoded; charset=...` 決定。瀏覽器通常按頁面編碼發送。
瀏覽器 (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 |