萬盛學電腦網

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

解決 JSP/Servlet 中文亂碼終極方案:Filter 統一編碼處理

中文亂碼是 JSP/Servlet 開發最頑固的問題之一。本文提供基於 Filter 過濾器 的統一解決方案,從請求進入到回應輸出全鏈路強制指定編碼,徹底解決 GET/POST/表單/URL/資料庫各環節亂碼。

核心原則:全鏈路編碼一致

  • JSP 頁面指令:<%@ page pageEncoding="UTF-8" %> (或 GB2312/Big5,專案統一)
  • Filter 初始化參數:<param-value>UTF-8</param-value> 必須與頁面編碼完全一致
  • 資料庫連線 URL:?useUnicode=true&characterEncoding=UTF-8
  • HTML Meta:<meta charset="UTF-8">
  • Java 檔案儲存編碼:IDE 設定為 UTF-8

完整實作:CharsetFilter

1. Filter 類別

package com.filter;

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

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

  @Override
  public void init(FilterConfig config) throws ServletException {
    String param = config.getInitParameter("encoding");
    if (param != null) encoding = param;
    System.out.println("[CharsetFilter] 初始化完成,編碼: " + encoding);
  }

  @Override
  public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
      throws IOException, ServletException {
    // 核心:強制設定請求/回應編碼
    req.setCharacterEncoding(encoding);
    res.setCharacterEncoding(encoding);
    res.setContentType("text/html;charset=" + encoding);
    chain.doFilter(req, res);
  }

  @Override
  public void destroy() { /* 資源清理 */ }
}

2. web.xml 註冊 (需放在所有其他 Filter 之前)

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

補充:GET 請求參數亂碼特殊處理 (Tomcat 8+)

Tomcat 8 預設使用 ISO-8859-1 解碼 URL 參數。兩種解決:

  1. server.xml <Connector> 加入 URIEncoding="UTF-8"
  2. 或在 Filter 中手動轉碼:
    String param = new String(req.getParameter("name").getBytes("ISO-8859-1"), "UTF-8");

驗證清單

環節檢查項目正確設定
JSP 頁面pageEncodingUTF-8
HTML 輸出meta charsetUTF-8
Filterinit-param encodingUTF-8 (與 pageEncoding 同)
Tomcat ConnectorURIEncodingUTF-8
資料庫連線characterEncodingUTF-8
資料庫表/欄位CHARSETutf8mb4 (MySQL) / AL32UTF8 (Oracle)
Java 原始碼檔案編碼UTF-8
亂碼本質是編碼不一致。Filter 方案將「設定編碼」集中化、強制化、最早化,是解決亂碼最穩健、維護成本最低的模式。
copyright © 萬盛學電腦網 all rights reserved