中文在傳輸鏈路中經歷:頁面編碼 → JS 編碼 → HTTP 傳輸 → 伺服器解碼 → 伺服器處理 → 回應編碼 → 瀏覽器解碼。任一環節不一致即產生亂碼。
<meta charset="utf-8">
<!-- 或舊寫法 -->
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
所有 .jsp/.html/.js 檔案儲存為 UTF-8 無 BOM。
response.setContentType("text/html;charset=UTF-8"); // 或 application/json;charset=UTF-8
response.setCharacterEncoding("UTF-8"); // 同效
PrintWriter out = response.getWriter(); // 之後寫入自動用 UTF-8
<!-- conf/server.xml -->
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443"
URIEncoding="UTF-8" />
重啟 Tomcat 生效。此設定讓 Tomcat 用 UTF-8 解碼 URL 查詢字串,GET 亂碼一勞永逸。
@WebFilter("/*")
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);
}
}
在 web.xml 註冊或 @WebFilter 自動掃描。確保所有請求/回應編碼一致。
jQuery 預設 contentType: "application/x-www-form-urlencoded; charset=UTF-8",POST 會正確發送 UTF-8。
GET 請求參數編碼:
// jQuery 內部會自動 encodeURIComponent,但舊版可能需手動雙重編碼
data: { userName: $('#userName').val() } // 直接傳物件,jQuery 自動編碼
// 切勿手動 encodeURI/encodeURIComponent 導致雙重編碼
在 jquery-x.x.x.js 中找到 contentType: "application/x-www-form-urlencoded" 改為:
contentType: "application/x-www-form-urlencoded;charset=UTF-8"
這確保所有 AJAX 請求標頭明確帶 charset。缺點:升級 jQuery 會遺失,建議改用 $.ajaxSetup({contentType: ...}) 全域設定。
Content-Type: application/x-www-form-urlencoded; charset=UTF-8Content-Type: text/html;charset=UTF-8 或 application/json;charset=UTF-8System.out.println(param) 觀察控制台輸出。fetch/axios,預設 JSON 格式 Content-Type: application/json;charset=UTF-8。@RestController 自動處理 UTF-8 JSON 序列化/反序列化。CHARSET=utf8mb4、連線字串 characterEncoding=utf8。charset utf-8;。亂碼核心在於「編碼不一致」。依序落實:檔案存儲 UTF-8 → 頁面 meta charset → Tomcat URIEncoding → Filter 強制編碼 → Servlet 回應設定 → AJAX contentType。現代前後端分離採用 JSON + UTF-8 全鏈路,徹底杜絕亂碼。