萬盛學電腦網

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

JSP Request 中文亂碼徹底解決:全鏈路 UTF-8 統一與 Filter 方案

亂碼根因

瀏覽器按頁面編碼發送請求 → 伺服器默認按 ISO-8859-1 解碼參數 → 中文字節錯誤拆分 → 亂碼。核心解法:**全鏈路統一編碼(推薦 UTF-8)**。

方案一:全鏈路 UTF-8 配置清單

  1. JSP 頁面:`<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>`
  2. HTML Meta:``
  3. JavaScript/表單:文件保存為 UTF-8,AJAX 發送前 `encodeURIComponent()`,表單添加 `accept-charset="UTF-8"`。
  4. Tomcat 連接器:`server.xml` `` 解決 GET 參數亂碼。
  5. 數據庫連接:JDBC URL `jdbc:mysql://...?characterEncoding=utf8&useUnicode=true`(MySQL 8.0+ 默認 utf8mb4)。
  6. 數據庫表/列:`CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci`。

方案二:字符編碼過濾器(核心推薦)

統一攔截所有請求,在讀取參數前強制設置編碼,兼容 GET/POST。

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

    public void init(FilterConfig config) {
        String e = config.getInitParameter("encoding");
        if (e != null) encoding = e;
        String f = config.getInitParameter("forceEncoding");
        if (f != null) force = 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 || force) {
                request.setCharacterEncoding(encoding);
            }
        } else {
            // GET: 包裝 Request 覆寫 getParameter
            request = new HttpServletRequestWrapper(request) {
                @Override
                public String getParameter(String name) {
                    return decode(super.getParameter(name));
                }
                @Override
                public String[] getParameterValues(String name) {
                    String[] vals = super.getParameterValues(name);
                    if (vals != null) for (int i=0;i

web.xml 配置(須置於所有 filter-mapping 之前)

<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>
  <init-param><param-name>forceEncoding</param-name><param-value>true</param-value></init-param>
</filter>
<filter-mapping>
  <filter-name>CharacterEncodingFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

數據庫層面的編碼處理

若無法像 MySQL 那樣通過連接串解決,通用做法:寫入前 `new String(str.getBytes("GBK"), "ISO-8859-1")`,讀取後反向轉換。但**強烈建議統一 UTF-8 避免雙向轉碼**,現代數據庫均完美支持 utf8mb4。

現代框架中的對應

  • Spring MVC:`web.xml` 配置 `CharacterEncodingFilter`(框架自帶),Spring Boot 自動配置 `server.servlet.encoding.*`。
  • Spring Boot 2.x+:`application.yml` 設置 `server.servlet.encoding.charset=UTF-8`、`force=true`、`enabled=true`。

總結

「全鏈路 UTF-8 + 字符編碼 Filter」是 JSP 時代解決 Request 亂碼的標準答案。現代項目直接使用框架內置支持,原理不變:在讀取參數前,按正確字符集解碼字節流。

copyright © 萬盛學電腦網 all rights reserved