中文亂碼是 JSP/Servlet 開發最頑固的問題之一。本文提供基於 Filter 過濾器 的統一解決方案,從請求進入到回應輸出全鏈路強制指定編碼,徹底解決 GET/POST/表單/URL/資料庫各環節亂碼。
<%@ page pageEncoding="UTF-8" %> (或 GB2312/Big5,專案統一)<param-value>UTF-8</param-value> 必須與頁面編碼完全一致?useUnicode=true&characterEncoding=UTF-8<meta charset="UTF-8">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() { /* 資源清理 */ }
}
<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>
Tomcat 8 預設使用 ISO-8859-1 解碼 URL 參數。兩種解決:
server.xml <Connector> 加入 URIEncoding="UTF-8"String param = new String(req.getParameter("name").getBytes("ISO-8859-1"), "UTF-8");| 環節 | 檢查項目 | 正確設定 |
|---|---|---|
| JSP 頁面 | pageEncoding | UTF-8 |
| HTML 輸出 | meta charset | UTF-8 |
| Filter | init-param encoding | UTF-8 (與 pageEncoding 同) |
| Tomcat Connector | URIEncoding | UTF-8 |
| 資料庫連線 | characterEncoding | UTF-8 |
| 資料庫表/欄位 | CHARSET | utf8mb4 (MySQL) / AL32UTF8 (Oracle) |
| Java 原始碼 | 檔案編碼 | UTF-8 |
亂碼本質是編碼不一致。Filter 方案將「設定編碼」集中化、強制化、最早化,是解決亂碼最穩健、維護成本最低的模式。