萬盛學電腦網

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

JSP 參數傳遞亂碼徹底解決:POST/GET 表單、URL、跨窗口傳值全場景覆蓋

亂碼本質:編碼解碼不一致

計算機底層只識別位元組。亂碼發生於:**發送端編碼 ≠ 接收端解碼**。統一全鏈路 UTF-8 是唯一正解。

場景一:表單 POST 提交

請求報文結構

POST /handle.jsp HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Content-Length: 49

username=%E4%B8%96%E7%95%8C%E6%9D%AF&password=123
<!-- %E4%B8%96%E7%95%8C%E6%9D%AF = "世界杯" 的 UTF-8 URL 編碼 -->

服務端處理流程

  1. Tomcat 根據 `Content-Type` 解析 Body
  2. **默認使用 ISO-8859-1 解碼** (Servlet 規範默認)
  3. 調用 `request.setCharacterEncoding("UTF-8")` 重新指定解碼器
  4. 後續 `getParameter()` 返回正確字符串

最佳實踐:字符編碼過濾器 (Filter)

@WebFilter("/*")
public class EncodingFilter implements Filter {
    private String encoding = "UTF-8";
    private boolean forceEncoding = true;

    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) resp;
        
        if (forceEncoding || request.getCharacterEncoding() == null) {
            request.setCharacterEncoding(encoding);
        }
        if (forceEncoding) {
            response.setCharacterEncoding(encoding);
        }
        chain.doFilter(request, response);
    }
}

配置在 `web.xml` 首位,覆蓋所有請求,**一次配置,全局生效**。

場景二:GET 請求 / URL 參數傳遞

問題

URL 中參數經過瀏覽器 URL 編碼 (通常 UTF-8),但 Tomcat **默認用 ISO-8859-1 解碼 Query String**。

方案對比

方案配置優點缺點
Tomcat 全局server.xml: `URIEncoding="UTF-8"`零代碼侵入,覆蓋所有 GET需修改服務器配置,遷移需同步
手動轉碼`new String(req.getParameter("k").getBytes("ISO-8859-1"), "UTF-8")`無需改配置極易遺漏,性能差,不推薦
Spring MVC`@RequestParam` 自動處理 (配合 Filter)框架層透明化依賴 Spring

生產建議

**統一修改 `server.xml` Connector 設置 `URIEncoding="UTF-8"`**,並配合 Filter 強制 POST 編碼,徹底消除參數亂碼。

場景三:跨窗口傳值 (window.opener / iframe)

JavaScript 獲取父頁面值

<!-- 子窗口 popup.jsp -->
<script>
    // 獲取父窗口輸入框值
    var parentVal = window.opener.document.getElementById('parentInput').value;
    // 或 jQuery
    var val = $(window.opener.document).find('#parentInput').val();
    
    // 寫回父窗口
    window.opener.document.getElementById('result').value = '選擇結果';
    window.opener.doCallback('selected'); // 調用父頁面函數
    window.close();
</script>

編碼注意點

  • JavaScript 內部使用 UTF-16,DOM 讀寫無編碼問題
  • 若涉及 URL 傳遞 (如 `window.open('child.jsp?val=' + encodeURIComponent(val))`),**必須 `encodeURIComponent`** 編碼,接收端 `decodeURIComponent` / 依賴 Filter 自動解碼

場景四:AJAX / Fetch 異步請求

// 發送端 (JS)
fetch('/api/save', {
    method: 'POST',
    headers: {'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8'},
    body: new URLSearchParams({name: '中文'}) // 自動 UTF-8 編碼
});

// 接收端 (Servlet/Controller)
request.setCharacterEncoding("UTF-8"); // Filter 已處理可省略
String name = request.getParameter("name"); // 正確
  • 現代瀏覽器 Fetch/XHR 默認 UTF-8 編碼 Body
  • 設置 `Content-Type` 明確聲明 `charset=UTF-8` 讓服務端正確解析

場景五:文件上傳

<form method="post" enctype="multipart/form-data">
    <input type="file" name="file"/>
    <input type="text" name="description"/>
</form>
  • `multipart/form-data` 不設置 charset,各部分自帶 `Content-Disposition` 頭
  • Commons FileUpload / Servlet 3.0 `request.getPart()` 會根據 Part Header 自動解碼
  • **確保 Filter 不干擾 multipart 請求** (Spring `MultipartFilter` 順序在 EncodingFilter 之後)

完整驗證清單

✅ 所有 .jsp/.java/.js/.css 文件保存為 UTF-8 (無 BOM)
✅ JSP 頁面: pageEncoding="UTF-8" contentType="text/html;charset=UTF-8"
✅ HTML: <meta charset="UTF-8">
✅ Tomcat server.xml: URIEncoding="UTF-8" useBodyEncodingForURI="true"
✅ web.xml: CharacterEncodingFilter (forceEncoding=true) 映射 /*
✅ JDBC URL: useUnicode=true&characterEncoding=utf8mb4
✅ 數據庫/表/列: CHARSET=utf8mb4 COLLATE=utf8mb4_unicode_ci
✅ JS URL 參數: encodeURIComponent() / decodeURIComponent()
✅ 下載文件名: RFC 5987 filename* 編碼
✅ 日志/控制台輸出: logback encoding=UTF-8
copyright © 萬盛學電腦網 all rights reserved