中文在「瀏覽器 → 網路傳輸 → 伺服器解碼 → 業務處理 → 編碼輸出 → 瀏覽器解碼顯示」每一環節編碼必須一致,任一環節錯配即產生亂碼。
<!-- 修改前 -->
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443" />
<!-- 修改後:強制 URI 解碼為 UTF-8 -->
<Connector port="8080" protocol="HTTP/1.1" connectionTimeout="20000" redirectPort="8443"
URIEncoding="UTF-8" />
<Connector port="8009" protocol="AJP/1.3" redirectPort="8443" URIEncoding="UTF-8" />
原理:Tomcat 解析 URL 時,若無 `URIEncoding`,預設用 `ISO-8859-1` 解碼 `%E4%BD%A0%E5%A5%BD` → 亂碼。設定 `URIEncoding="UTF-8"` 統一解碼。
// 單個參數編碼
var title = "中文標題";
var encoded = encodeURIComponent(title); // 推薦:僅編碼參數值,不編碼 & = ? /
// 或雙重編碼 (舊專案相容)
var encoded = encodeURI(encodeURIComponent(title));
// 組裝 URL
var url = "<%=request.getContextPath()%>/print/printList!printTable.action?title=" + encoded;
// 通用解碼工具方法
public static String decodeParam(String encoded) {
try {
return java.net.URLDecoder.decode(encoded, "UTF-8");
} catch (UnsupportedEncodingException e) {
throw new RuntimeException(e);
}
}
// Controller 中使用
String title = decodeParam(request.getParameter("title"));
<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
// 獲取參數時轉碼 (GET 請求參數常受 URIEncoding 影響)
String param = new String(request.getParameter("p").getBytes("ISO-8859-1"), "UTF-8");
// 輸出時轉碼 (極少見)
String output = new String(internalString.getBytes("UTF-8"), "ISO-8859-1");
# MySQL (JDBC URL)
jdbc:mysql://localhost/db?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
# Oracle (JDBC 屬性 或 NLS_LANG 環境變數)
Properties props = new Properties();
props.setProperty("user", "scott");
props.setProperty("password", "tiger");
props.setProperty("oracle.jdbc.defaultNChar", "true"); // 支援 NCHAR/NVARCHAR2
**全鏈路 UTF-8** 是唯一銀彈。歷史專案若無法全面改造,請在**邊界層** (Filter/Controller) 統一轉碼,業務層純用 Unicode (Java `String` 內部即 UTF-16),避免到處散落 `getBytes/ new String` 亂碼製造機。