編碼鏈路任一環節不一致即產生亂碼:
**瀏覽器編碼 → 請求傳輸 → Tomcat 解碼 → Java 字串 → 業務處理 → 回應編碼 → 瀏覽器解碼**
<%@ page language="java" pageEncoding="UTF-8" contentType="text/html;charset=UTF-8" %>
pageEncoding="UTF-8":JSP 檔案儲存編碼,編譯期讀取用。contentType="text/html;charset=UTF-8":回應 HTTP 標頭編碼,瀏覽器顯示用。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() {}
}
<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>
Locale 動態切換編碼。<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 處理)。| 方法 | 解決 GET | 解決 POST | 解決頁面顯示 | 維護性 | 推薦度 |
|---|---|---|---|---|---|
| 頁面指令 | 否 | 否 | 是 | 需每頁寫入 | ★★☆ (基礎必做) |
| Encoding Filter | 是 | 是 | 輔助 | 一次配置全局生效 | ★★★★★ (核心) |
| Tomcat URIEncoding | 是 | 否 | 否 | 伺服器級配置 | ★★★☆ (輔助) |
pageEncoding="UTF-8" contentType="text/html;charset=UTF-8"。/*,forceEncoding=true。server.xml URIEncoding="UTF-8"。?useUnicode=true&characterEncoding=UTF-8。CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci。javac -encoding UTF-8 / Maven <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>。**「Filter + URIEncoding + 頁面指令」三管齊下** 是企業級專案標準做法。新專案從模板階段就內建 Encoding Filter,老專案優先加入 Filter 統一管理,徹底根治中文亂碼。