Java Web 中文亂碼全鏈路排查與解決方案

亂碼產生環節

1. 頁面編碼：JSP/HTML 頭部 <%@ page contentType="text/html;charset=UTF-8" %>、<meta charset="UTF-8">。
2. 請求解碼：request.setCharacterEncoding("UTF-8")（需在獲取參數前調用，僅對 POST 有效）。
3. 響應編碼：response.setContentType("text/html;charset=UTF-8") 或 response.setCharacterEncoding("UTF-8")。
4. Servlet 容器：Tomcat server.xml <Connector URIEncoding="UTF-8"> 解決 GET 參數亂碼。
5. 數據庫連接：JDBC URL 追加 ?characterEncoding=utf8mb4&useSSL=false，數據庫/表/列字符集為 utf8mb4。
6. 文件存儲：Java 源文件保存為 UTF-8，避免 IDE 默認 GBK 導致字面量編碼錯誤。

快速定位步驟

• 檢查數據庫中存儲的原始字節（HEX(col)），若已亂碼則問題在寫入鏈路；若正常則在讀取/顯示鏈路。
• 分別在 Controller、Service、DAO 打印日志，縮小範圍。

核心原則

**全鏈路統一 UTF-8（推薦 utf8mb4）**，任何一環不一致都會導致亂碼。