JSP/Servlet 中文亂碼徹底解決方案

問題現象

JSP 頁面傳遞中文參數到 Servlet，接收到的全是亂碼（如 ????? 或 ）。試遍網上方法仍無效，最終發現只需在 Tomcat 配置中加入一行即可解決。

根本原因

Tomcat 預設使用 ISO-8859-1 解碼 URL 參數。瀏覽器以 UTF-8 編碼發送請求，Tomcat 用 ISO-8859-1 解碼，導致位元組序列錯誤解讀為亂碼。

解決方案：修改 server.xml

步驟

1. 開啟 Tomcat 安裝目錄
2. 進入 conf 資料夾
3. 編輯 server.xml
4. 找到 <Connector 標籤（通常在 port="8080" 附近）
5. 在標籤結尾處加入 URIEncoding="UTF-8"

修改前

<Connector port="8080" protocol="HTTP/1.1" 
           connectionTimeout="20000" 
           redirectPort="8443" />

修改後

<Connector port="8080" protocol="HTTP/1.1" 
           connectionTimeout="20000" 
           redirectPort="8443" 
           URIEncoding="UTF-8" />

重啟 Tomcat 即可生效

為什麼這一行就能解決？

• URIEncoding 指定 Tomcat 解碼 URL 參數（GET 請求查詢字串、路徑參數）時使用的字元集
• 設為 UTF-8 後，Tomcat 正確解碼瀏覽器發送的 UTF-8 位元組序列
• 影響範圍：request.getParameter()、request.getQueryString()、request.getRequestURI() 等

完整的中文編碼最佳實踐

雖然 URIEncoding="UTF-8" 解決 GET 請求，但完整專案還需處理 POST、JSP 頁面、資料庫、檔案等編碼：

1. Web.xml 過濾器統一設定（推薦）

<filter>
    <filter-name>CharacterEncodingFilter</filter-name>
    <filter-class>org.springframework.web.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>

Spring 專案直接使用 CharacterEncodingFilter；非 Spring 專案可自寫簡單 Filter：

public class EncodingFilter implements Filter {
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
        req.setCharacterEncoding("UTF-8");
        resp.setCharacterEncoding("UTF-8");
        resp.setContentType("text/html;charset=UTF-8");
        chain.doFilter(req, resp);
    }
}

2. JSP 頁面指令

<%@ page contentType="text/html;charset=UTF-8" pageEncoding="UTF-8" %>

3. HTML Meta 標籤

<meta charset="UTF-8">
<!-- 或舊版 -->
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">

4. Java 代碼中處理

// GET 參數手動修正（若無法修改 server.xml）
String param = request.getParameter("name");
if (param != null) {
    param = new String(param.getBytes("ISO-8859-1"), "UTF-8");
}

// 表單提交指定編碼
// 

5. 資料庫連線編碼

// MySQL JDBC URL
jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Taipei

// PostgreSQL
jdbc:postgresql://localhost:5432/mydb?charSet=UTF-8

6. 檔案讀寫編碼

// 讀取
Files.readAllLines(Paths.get("file.txt"), StandardCharsets.UTF_8);

// 寫入
Files.write(Paths.get("file.txt"), content.getBytes(StandardCharsets.UTF_8));

Tomcat 版本差異

驗證方法

// 測試 Servlet
@WebServlet("/test")
public class EncodingTestServlet extends HttpServlet {
    protected void doGet(HttpServletRequest req, HttpServletResponse resp) {
        String name = req.getParameter("name");
        resp.setContentType("text/plain;charset=UTF-8");
        resp.getWriter().write("接收到參數: " + name);
    }
}

瀏覽器訪問：https://localhost:8080/test?name=中文測試
正確顯示：接收到參數: 中文測試

常見誤區

結語

JSP/Servlet 中文亂碼的核心在於統一編碼鏈路：瀏覽器 → Tomcat (URIEncoding) → Filter (request/response encoding) → JSP (pageEncoding) → HTML (meta charset) → 資料庫 → 檔案。其中 Tomcat 的 URIEncoding="UTF-8" 是解決 GET 請求中文亂碼的關鍵一招，配合全鏈路 UTF-8 設定，徹底杜絕亂碼問題。