Web 應用中文支持實驗：全鏈路 UTF-8 驗證報告

實驗環境

• OS：Linux (默認 UTF-8)
• Server：Tomcat 5.0.28
• DB：PostgreSQL / MySQL
• 架構：JSP → JavaBean → Controller → DAO

核心發現

1. 數據庫層：直接寫入中文正常，無需額外設置（受益於 OS 默認 UTF-8）。
2. JSP 編譯：必須在頁面頭部聲明 <%@ page pageEncoding="UTF-8" %>，否則 Tomcat 編譯時用默認編碼導致數據丟失。
3. 請求參數：需在獲取參數前設置 request.setCharacterEncoding("UTF-8")。最佳實踐：配置 CharacterEncodingFilter 映射 /*，初始化參數 charset=UTF-8。
4. 響應輸出：JSP 頁面與 HTML meta 雙重聲明 UTF-8。
5. 數據庫連接：JDBC URL 顯式指定 characterEncoding=UTF-8。

Filter 實現代碼

public class EncodingFilter implements Filter {
    private String encoding = "UTF-8";
    public void init(FilterConfig cfg) { encoding = cfg.getInitParameter("charset"); }
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain) {
        req.setCharacterEncoding(encoding);
        chain.doFilter(req, res);
    }
    public void destroy() {}
}

web.xml 註冊

<filter>
    <filter-name>Character Encoding Filter</filter-name>
    <filter-class>com.example.EncodingFilter</filter-class>
    <init-param><param-name>charset</param-name><param-value>UTF-8</param-value></init-param>
</filter>
<filter-mapping>
    <filter-name>Character Encoding Filter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

跨平台驗證

同一 WAR 部署到 Windows XP (默認 CP1252) + 同樣數據庫/服務器，應用程序正常運行，證明全鏈路 UTF-8 消除了平台相關性。數據庫控制台查詢因 OS 編碼不同顯示亂碼，但不影響應用邏輯。

結論

統一指定 UTF-8 為唯一可靠的中文解決方案，適用於所有框架（Struts、Spring、Hibernate 等），一次配置，終身受益。