亂碼是 Java Web 開發的「頭號公敵」。本文針對虛擬主機/共享主機環境,系統梳理三大高發場景:**表單提交、資料庫存儲、JDBC 讀取**,給出針對性修復方案。
頁面顯示正常,但新增資料入庫後全變亂碼。原因:請求參數在伺服器端解碼錯誤,錯誤位元組直接入庫。
編輯 $CATALINA_HOME/conf/server.xml,找到 `URIEncoding="UTF-8"(或 GB2312/GBK,視專案編碼而定):
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
URIEncoding="UTF-8" />
重啟 Tomcat,所有 GET/POST 參數自動按指定編碼解碼。
public class EncodingFilter implements Filter {
private String encoding = "UTF-8";
public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
req.setCharacterEncoding(encoding);
resp.setCharacterEncoding(encoding);
chain.doFilter(req, resp);
}
// init/destroy 略
}
在 web.xml 註冊為首個 Filter,攔截 /*。
String correct = new String(request.getParameter("param").getBytes("ISO-8859-1"), "UTF-8");
原理:Tomcat 預設用 ISO-8859-1 解碼 POST 體,先還原位元組再以正確編碼重組。缺點:侵入業務碼、易漏。
使用資料庫客戶端(Navicat, DBeaver, Workbench 等)分別以 **UTF-8、GBK、Latin1** 連線查看同一張表:
資料庫內容正常,Java 讀出即亂碼。
jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true
關鍵點:
useUnicode=true必須開啟。characterEncoding=UTF-8強制驅動以 UTF-8 解碼結果集。- **不要**設為 GB2312/GBK,驅動會雙重轉碼導致更亂。
- Hibernate
hibernate.cfg.xml中 URL 不能含&,需寫&或用 CDATA。
<%@ page pageEncoding="UTF-8" contentType="text/html;charset=UTF-8"%><form accept-charset="UTF-8">URIEncoding="UTF-8" 或 Filter 設定 request.setCharacterEncoding("UTF-8")characterEncoding=UTF-8utf8mb4_general_ci(支援 Emoji)response.setContentType("text/html;charset=UTF-8")**全鏈路 UTF-8**,亂碼自然消失。