Struts 1 中文表單亂碼徹底解決：Filter 與 ActionServlet 兩大方案實戰

Struts 1 直接將表單數據填充至 ActionForm，過程中未對 HttpServletRequest 執行 setCharacterEncoding()，導致預設使用 ISO-8859-1 解碼，中文產生亂碼。本文提供兩種經典解決方案：全域 Filter 方案（推薦）與 自訂 ActionServlet 方案，並解析原理與配置細節。

根因分析

Tomcat org.apache.catalina.connector.HttpRequestBase.parseParameters() 預設以 ISO-8859-1 解碼請求參數。Struts 1 在 ActionServlet.process() 內部才建立 ActionForm 並填充屬性，此時若未預先設定請求編碼，中文已在解碼階段損壞，無法恢復。

方案一：全域編碼 Filter（推薦，通用性最強）

Filter 實作

package com.example.filter;

import java.io.IOException;
import javax.servlet.*;

public class CharacterEncodingFilter implements Filter {
    private String encoding = "UTF-8";

    @Override
    public void init(FilterConfig config) throws ServletException {
        String cfg = config.getInitParameter("encoding");
        if (cfg != null && !cfg.trim().isEmpty()) encoding = cfg;
    }

    @Override
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain)
            throws IOException, ServletException {
        req.setCharacterEncoding(encoding);
        resp.setCharacterEncoding(encoding); // 統一回應編碼
        chain.doFilter(req, resp);
    }

    @Override
    public void destroy() {}
}

web.xml 配置（務必置於所有 Filter 之前）

<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>com.example.filter.CharacterEncodingFilter</filter-class>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

方案二：繼承 ActionServlet 覆寫 process()

自訂 Servlet

package com.example.struts;

import javax.servlet.*;
import javax.servlet.http.*;
import org.apache.struts.action.ActionServlet;

public class EncodingActionServlet extends ActionServlet {
    @Override
    protected void process(HttpServletRequest req, HttpServletResponse resp)
            throws IOException, ServletException {
        String encoding = getInitParameter("encoding");
        if (encoding != null) req.setCharacterEncoding(encoding);
        super.process(req, resp);
    }
}

web.xml 配置（替換預設 ActionServlet）

<servlet>
    <servlet-name>action</servlet-name>
    <servlet-class>com.example.struts.EncodingActionServlet</servlet-class>
    <init-param>
        <param-name>config</param-name>
        <param-value>/WEB-INF/struts-config.xml</param-value>
    </init-param>
    <init-param>
        <param-name>encoding</param-name>
        <param-value>UTF-8</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>action</servlet-name>
    <url-pattern>*.do</url-pattern>
</servlet-mapping>

兩方案對比與選型建議

補充：JSP 頁面編碼宣告（雙重保險）

<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>

確保 JSP 編譯與輸出編碼一致，避免頁面顯示亂碼。

總結

Struts 1 中文亂碼本質是請求參數解碼時機過晚。**全域 Filter 方案**符合 Servlet 規範、覆蓋面最廣、維護成本最低，是首選最佳實踐。配合 JSP 頁面編碼宣告，可徹底消除中文亂碼問題。