萬盛學電腦網

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

JSP 中文亂碼徹底解決:工具類封裝與 Filter 過濾器雙重保障

亂碼本質

瀏覽器按頁面編碼發送請求 → 伺服器按默認 ISO-8859-1 解碼 → 中文字節被錯誤拆分 → 亂碼。解決核心:統一指定編碼(UTF-8/GBK)。

方案一:工具類手動轉碼(不推薦,侵入代碼)

<%!
public String toChinese(String str) {
    if (str == null) return null;
    try {
        return new String(str.getBytes("ISO-8859-1"), "GBK"); // 或 UTF-8
    } catch (UnsupportedEncodingException e) {
        return str;
    }
}
%>
// 使用
String name = toChinese(request.getParameter("name"));

缺點:每個參數都要調用,漏調即亂碼,維護成本高。

方案二:字符編碼過濾器(推薦,一勞永逸)

核心類:Request Wrapper 統一處理 GET/POST

public class EncodingFilter implements Filter {
    private String encoding = "UTF-8";
    private boolean forceEncoding = true;

    public void init(FilterConfig config) {
        String e = config.getInitParameter("encoding");
        if (e != null) encoding = e;
        String f = config.getInitParameter("forceEncoding");
        if (f != null) forceEncoding = Boolean.parseBoolean(f);
    }

    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) resp;

        // POST: 直接設置編碼(必須在讀取參數前)
        if ("POST".equalsIgnoreCase(request.getMethod())) {
            if (request.getCharacterEncoding() == null || forceEncoding) {
                request.setCharacterEncoding(encoding);
            }
        } else {
            // GET: 包裝 Request 覆寫 getParameter 系列方法
            request = new HttpServletRequestWrapper(request) {
                @Override
                public String getParameter(String name) {
                    String value = super.getParameter(name);
                    return decode(value);
                }
                @Override
                public String[] getParameterValues(String name) {
                    String[] values = super.getParameterValues(name);
                    if (values != null) {
                        for (int i = 0; i < values.length; i++) values[i] = decode(values[i]);
                    }
                    return values;
                }
                private String decode(String value) {
                    if (value == null) return null;
                    try {
                        return new String(value.getBytes("ISO-8859-1"), encoding);
                    } catch (UnsupportedEncodingException e) {
                        return value;
                    }
                }
            };
        }
        chain.doFilter(request, response);
    }
}

web.xml 配置

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

全鏈路 UTF-8 清單

  1. JSP 頁面:<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>
  2. HTML Meta:<meta charset="UTF-8">
  3. JavaScript:文件保存為 UTF-8,AJAX 發送前 encodeURIComponent。
  4. Tomcat server.xml:<Connector URIEncoding="UTF-8" .../>
  5. 數據庫連接:JDBC URL 追加 ?characterEncoding=utf8&useUnicode=true(MySQL)
  6. 數據庫表/列:CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci

總結

Filter 方案屏蔽了 GET/POST 差異,對業務代碼零侵入,是 JSP 時代解決亂碼的標準做法。現代框架(Spring MVC)已內置 CharacterEncodingFilter,直接配置即用。

copyright © 萬盛學電腦網 all rights reserved