Struts + Hibernate 中文亂碼終極解決方案：全鏈路編碼過濾器實戰

問題根源

Struts + Hibernate 應用中，HTTP 請求參數編碼、JSP 頁面編碼、數據庫連接編碼、JVM 文件編碼不一致，導致中文存儲讀取亂碼。核心缺口：Servlet 規範未強制要求容器按指定編碼解碼請求參數。

解決方案：字符編碼過濾器

基於 Servlet Filter 攔截所有請求，在參數讀取前強制設置編碼。

1. web.xml 註冊過濾器 (務必放在首位)

<filter>
  <filter-name>Set Character Encoding</filter-name>
  <filter-class>com.company.demo.util.SetEncodingFilter</filter-class>
  <init-param>
    <param-name>encoding</param-name>
    <param-value>GB2312</param-value>  <!-- 或 UTF-8 -->
  </init-param>
</filter>
<filter-mapping>
  <filter-name>Set Character Encoding</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

2. 過濾器實現 (SetEncodingFilter.java)

package com.company.demo.util;
import java.io.IOException;
import javax.servlet.*;

public class SetEncodingFilter implements Filter {
    protected String encoding = null;
    protected FilterConfig filterConfig = null;
    protected boolean ignore = true; // 默認忽略客戶端指定編碼

    public void destroy() {
        encoding = null; filterConfig = null;
    }

    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 若忽略模式 或 請求未設置編碼，則強制設置
        if (ignore || request.getCharacterEncoding() == null) {
            request.setCharacterEncoding(selectEncoding(request));
        }
        chain.doFilter(request, response);
    }

    public void init(FilterConfig filterConfig) throws ServletException {
        this.filterConfig = filterConfig;
        this.encoding = filterConfig.getInitParameter("encoding");
        String value = filterConfig.getInitParameter("ignore");
        if (value == null) this.ignore = true;
        else this.ignore = "true".equalsIgnoreCase(value) || "yes".equalsIgnoreCase(value);
    }

    protected String selectEncoding(ServletRequest request) {
        return this.encoding; // 可擴展：根據請求動態決定編碼
    }
    // getter/setter 省略
}

全鏈路編碼一致性檢查清單

進階建議

• 統一 UTF-8：新項目強烈建議全棧 UTF-8，避免 GB2312/UTF-8 混用轉換損耗
• 過濾器順序：編碼過濾器必須在 ActionContextCleanUp、OpenSessionInViewFilter 等之前
• 響應編碼：response.setContentType("text/html;charset=UTF-8") 或 JSP 頁面指令雙重保障
• GET 請求：Tomcat 8+ 需在 server.xml <Connector URIEncoding="UTF-8"/> 解決 GET 參數亂碼

總結

字符編碼過濾器是解決 Struts/Hibernate 中文亂碼的標準化、可復用方案。配合全鏈路編碼一致性檢查，可徹底消除「存進去是亂碼、讀出來是問號」的持久化層噩夢。

1. 上一篇文章： 我選擇 Hibernate 的理由：從 JDO 挫折到 ORM 真愛的架構師思考
2. 下一篇文章： JBoss 3.2.6 實戰教程：從安裝到編寫部署第一個 HelloWorld EJB

Java 相關知識

擴展 Spring JMX 支援：外部 XML 元資料與通知事件實戰

前言 Spring 1.2+ 提供優秀的 JMX 整合，但預

Java 實現 SSH 協議客戶端認證：從協議原理到密碼/公鑰/鍵盤交互實戰

SSH 協議架構回顧 SSH（Secure Shell Pr

Struts 2 轉換器（Converter）完整指南：類型轉換、批次封裝與錯誤處理

為什麼需要轉換器？ Web 應用基於 HTTP 協定，瀏覽器

Apache POI 實戰：Java 讀寫 Excel (.xls/.xlsx) 完整教學與代碼範例

專案結構與依賴 專案目錄 ├── src/ │ ├──