HTTP 協議基於 ISO-8859-1 傳輸,而中文需雙字節編碼。瀏覽器發送請求時會按頁面編碼(或默認 UTF-8)對參數進行 URL 編碼;伺服器端若不指定解碼字符集,會按 ISO-8859-1 解碼,導致亂碼。
// 接收頁
String type = request.getParameter("type");
String result = new String(type.getBytes("ISO-8859-1"), "GBK"); // 或 UTF-8
原理:將錯誤解碼的字節按 ISO-8859-1 取回,再按正確字符集重構。
發送端:<a href='page.jsp?param=<%=URLEncoder.encode("中文", "UTF-8")%>'>
接收端:String val = URLDecoder.decode(request.getParameter("param"), "UTF-8");
若伺服器默認編碼非 UTF-8,可能仍需雙重轉換:new String(val.getBytes("ISO-8859-1"), "UTF-8")。
發送頁:<form method="post" accept-charset="UTF-8">
接收頁:在讀取參數前調用 request.setCharacterEncoding("UTF-8"),後直接 request.getParameter() 即可正確獲取。
Tomcat 8+ 默認使用 UTF-8 解碼 URL 查詢字符串。舊版本需在 server.xml <Connector> 添加 URIEncoding="UTF-8",或同 POST 一樣手動轉碼:new String(param.getBytes("ISO-8859-1"), "UTF-8")。
在 web.xml 配置 Filter,對所有請求強制設置編碼:
public class EncodingFilter implements Filter {
private String encoding = "UTF-8";
public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
if (req.getCharacterEncoding() == null) req.setCharacterEncoding(encoding);
resp.setCharacterEncoding(encoding);
chain.doFilter(req, resp);
}
}
配置 <url-pattern>/*</url-pattern> 即可一勞永逸。
encodeURIComponent():編碼單個參數值(推薦)。encodeURI():編碼整個 URL,不編碼結構字符(:,/,?,#)。escape():已棄用,勿用。統一全鏈路 UTF-8(頁面、JS、表單、伺服器、數據庫)是根治之道。配置 Filter + Tomcat URIEncoding + 數據庫連接串 characterEncoding=utf8,徹底告別亂碼。