萬盛學電腦網

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

解決 JSP 開發中文顯示亂碼的三大核心方法

亂碼根本原因

編碼鏈路任一環節不一致即產生亂碼:
**瀏覽器編碼 → 請求傳輸 → Tomcat 解碼 → Java 字串 → 業務處理 → 回應編碼 → 瀏覽器解碼**

方法一:JSP 頁面指令設定(最基礎、必做)

<%@ page language="java" pageEncoding="UTF-8" contentType="text/html;charset=UTF-8" %>
  • pageEncoding="UTF-8":JSP 檔案儲存編碼,編譯期讀取用。
  • contentType="text/html;charset=UTF-8":回應 HTTP 標頭編碼,瀏覽器顯示用。
  • GBK/GB2312 僅支援簡體,UTF-8 支援全球語言,**強烈建議統一 UTF-8**。

方法二:編碼 Filter 統一處理請求/回應編碼(核心推薦)

Filter 實作

package com.filter;

import jakarta.servlet.*;
import jakarta.servlet.http.*;
import java.io.IOException;

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

  @Override
  public void init(FilterConfig config) {
    String enc = config.getInitParameter("encoding");
    if (enc != null) encoding = enc;
    String fre = config.getInitParameter("forceRequestEncoding");
    if (fre != null) forceRequestEncoding = Boolean.parseBoolean(fre);
    String fre2 = config.getInitParameter("forceResponseEncoding");
    if (fre2 != null) forceResponseEncoding = Boolean.parseBoolean(fre2);
  }

  @Override
  public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain)
      throws IOException, ServletException {
    HttpServletRequest request = (HttpServletRequest) req;
    HttpServletResponse response = (HttpServletResponse) resp;
    
    if (forceRequestEncoding && request.getCharacterEncoding() == null) {
      request.setCharacterEncoding(encoding);
    }
    if (forceResponseEncoding) {
      response.setCharacterEncoding(encoding);
      response.setContentType("text/html;charset=" + encoding);
    }
    chain.doFilter(request, response);
  }

  @Override
  public void destroy() {}
}

web.xml 配置(優先順序最高,最先攔截)

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

優勢

  • **一次配置,全專案生效**
  • **同時解決 GET/POST 亂碼**
  • 支援國際化:配合 Locale 動態切換編碼。
  • 不侵入業務代碼,符合關注點分離。

方法三:Tomcat server.xml 設定 URIEncoding(解決 GET 亂碼)

<Connector port="8080" protocol="HTTP/1.1"
  connectionTimeout="20000"
  redirectPort="8443"
  URIEncoding="UTF-8"
  useBodyEncodingForURI="true" />
  • URIEncoding:指定 URL 查詢字串解碼編碼(GET 參數)。
  • useBodyEncodingForURI:若未設 URIEncoding,回退使用 request body 編碼(POST 已由 Filter 處理)。
  • Tomcat 8.5+ / 9.0+ / 10.1+ **預設即為 UTF-8**,通常無需修改。

三大方法適用場景對比

方法解決 GET解決 POST解決頁面顯示維護性推薦度
頁面指令否否是需每頁寫入★★☆ (基礎必做)
Encoding Filter是是輔助一次配置全局生效★★★★★ (核心)
Tomcat URIEncoding是否否伺服器級配置★★★☆ (輔助)

完整編碼鏈路檢查清單

  1. JSP 檔案儲存為 UTF-8(IDE 設定)。
  2. 所有 JSP 加 pageEncoding="UTF-8" contentType="text/html;charset=UTF-8"。
  3. 配置 Encoding Filter 映射 /*,forceEncoding=true。
  4. Tomcat server.xml URIEncoding="UTF-8"。
  5. JDBC 連線字串 ?useUnicode=true&characterEncoding=UTF-8。
  6. 資料庫/表/欄位 CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci。
  7. Java 原始碼編譯編碼 javac -encoding UTF-8 / Maven <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>。

結語

**「Filter + URIEncoding + 頁面指令」三管齊下** 是企業級專案標準做法。新專案從模板階段就內建 Encoding Filter,老專案優先加入 Filter 統一管理,徹底根治中文亂碼。

copyright © 萬盛學電腦網 all rights reserved