萬盛學電腦網

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

Java Web 中文亂碼終極解決方案:Tomcat、反向代理、URL、JSP、傳輸全鏈路

亂碼根因:編碼鏈路不一致

中文在「瀏覽器 → 網路傳輸 → 伺服器解碼 → 業務處理 → 編碼輸出 → 瀏覽器解碼顯示」每一環節編碼必須一致,任一環節錯配即產生亂碼。

第一層:Tomcat 連接器配置 (伺服器端入口)

HTTP/1.1 連接器 (port 8080)

<!-- 修改前 -->
<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" />

AJP 連接器 (port 8009,前端有 Apache/Nginx 時必須配)

<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"` 統一解碼。

第二層:URL 參數傳遞編解碼 (前後端協議)

前端 (JavaScript) 編碼

// 單個參數編碼
var title = "中文標題";
var encoded = encodeURIComponent(title); // 推薦:僅編碼參數值,不編碼 & = ? /
// 或雙重編碼 (舊專案相容)
var encoded = encodeURI(encodeURIComponent(title));

// 組裝 URL
var url = "<%=request.getContextPath()%>/print/printList!printTable.action?title=" + encoded;

後端 (Java) 解碼

// 通用解碼工具方法
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"));

第三層:JSP 頁面編碼聲明

<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
  • `pageEncoding="UTF-8"`:JSP 檔案本身以 UTF-8 存檔,容器正確讀取編譯。
  • `contentType="text/html;charset=UTF-8"`:響應 Header `Content-Type: text/html;charset=UTF-8`,瀏覽器以 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

第六層:檔案/日誌/外部系統編碼

  • Java 原始碼檔案:IDE 設定 **UTF-8** (File Encoding)
  • 屬性檔 (`*.properties`):Java 9+ 支援 UTF-8,舊版須用 `native2ascii` 轉 Unicode 轉義
  • 日誌輸出:Logback/Log4j2 設定 `UTF-8`
  • 外部 API 呼叫:確認對方文檔要求編碼,雙邊一致

一鍵檢查清單

  1. ☑ 所有 `.java`、`.jsp`、`.js`、`.css`、`.properties` 檔案 **UTF-8 無 BOM** 存檔
  2. ☑ IDE/編輯器 File Encoding 設為 UTF-8
  3. ☑ Tomcat `server.xml` 所有 Connector 加 `URIEncoding="UTF-8"`
  4. ☑ JSP 頁面指令 `<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>`
  5. ☑ 前端 AJAX/Form 參數用 `encodeURIComponent()` 編碼
  6. ☑ 後端 Controller 統一用 `URLDecoder.decode(param, "UTF-8")` 或配置 `CharacterEncodingFilter` (Spring `forceEncoding=true`)
  7. ☑ 資料庫 JDBC URL 含 `characterEncoding=UTF-8`
  8. ☑ 資料庫表/欄位 Collation 為 `utf8mb4_general_ci` (MySQL) / `AL32UTF8` (Oracle)

總結

**全鏈路 UTF-8** 是唯一銀彈。歷史專案若無法全面改造,請在**邊界層** (Filter/Controller) 統一轉碼,業務層純用 Unicode (Java `String` 內部即 UTF-16),避免到處散落 `getBytes/ new String` 亂碼製造機。

copyright © 萬盛學電腦網 all rights reserved