Java/J2EE 中文亂碼終極解決方案：全鏈路 UTF-8 統一

亂碼根因

Java 內部使用 UTF-16，但輸入/輸出邊界（瀏覽器、數據庫、文件、JSP 編譯、操作系統）均依賴環境默認編碼。跨平台導致編碼不一致，產生亂碼。

統一編碼原則

全鏈路強制 UTF-8：開發、編譯、運行、數據庫、前端、中間件全部指定 UTF-8，不依賴任何環境默認值。

具體實施步驟

1. IDE/編譯：項目屬性設置編碼為 UTF-8（Eclipse/IDEA/ JBuilder 均支持）。
2. 請求過濾器：配置 CharacterEncodingFilter，request.setCharacterEncoding("UTF-8")，映射 /*。
3. JSP 頁面聲明：<%@ page pageEncoding="UTF-8" %> 及 HTML meta <meta charset="UTF-8">。
4. 響應編碼：response.setContentType("text/html;charset=UTF-8") 或 Filter 統一設置。
5. 數據庫連接：JDBC URL 參數 useUnicode=true&characterEncoding=UTF-8（MySQL），其他庫類似。
6. 文件/XML 操作：讀寫時顯式指定 StandardCharsets.UTF_8。
7. 服務器配置：Tomcat server.xml <Connector URIEncoding="UTF-8"/>。

驗證清單

• 瀏覽器提交表單 → Filter 解碼 → Java 內部處理 → 數據庫存儲 → 查詢 → JSP 輸出 → 瀏覽器顯示，全程無亂碼。
• 切換操作系統（Windows/Linux）不影響運行。
• 支持多語言（中、英、日、韓等）共存。

避坑指南

• 不要使用 ISO-8859-1 或 GBK 作為統一編碼，會綁定特定平台。
• 不要依賴容器默認編碼，必須顯式配置。
• 框架（Struts/Spring/Hibernate）均遵循此原則，配置一次受益終身。