萬盛學電腦網

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

JSP 虛擬主機亂碼終極排查指南:POST、資料庫、JDBC 三大場景全解析

前言

亂碼是 Java Web 開發的「頭號公敵」。本文針對虛擬主機/共享主機環境,系統梳理三大高發場景:**表單提交、資料庫存儲、JDBC 讀取**,給出針對性修復方案。

場景一:POST 表單提交亂碼

現象

頁面顯示正常,但新增資料入庫後全變亂碼。原因:請求參數在伺服器端解碼錯誤,錯誤位元組直接入庫。

方案 A:修改 Tomcat server.xml(一勞永逸)

編輯 $CATALINA_HOME/conf/server.xml,找到 ``,新增 URIEncoding="UTF-8"(或 GB2312/GBK,視專案編碼而定):

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

重啟 Tomcat,所有 GET/POST 參數自動按指定編碼解碼。

方案 B:Filter 統一編碼(靈活、不改伺服器配置)

public class EncodingFilter implements Filter {
    private String encoding = "UTF-8";
    public void doFilter(ServletRequest req, ServletResponse resp, FilterChain chain) {
        req.setCharacterEncoding(encoding);
        resp.setCharacterEncoding(encoding);
        chain.doFilter(req, resp);
    }
    // init/destroy 略
}

在 web.xml 註冊為首個 Filter,攔截 /*。

方案 C:手動轉碼(不推薦,僅救急)

String correct = new String(request.getParameter("param").getBytes("ISO-8859-1"), "UTF-8");

原理:Tomcat 預設用 ISO-8859-1 解碼 POST 體,先還原位元組再以正確編碼重組。缺點:侵入業務碼、易漏。

場景二:資料庫本身存的是亂碼

判斷方法

使用資料庫客戶端(Navicat, DBeaver, Workbench 等)分別以 **UTF-8、GBK、Latin1** 連線查看同一張表:

  • 若**所有編碼下均顯示亂碼** → 資料落庫時已損壞。
  • 若某編碼下正常 → 資料正確,問題在讀取端編碼不匹配。

修復

  1. 客戶端以 **GBK/UTF-8** 連線(視目標編碼)。
  2. 重新執行建表/插入腳本,確保寫入位元組正確。
  3. 若資料量大,可寫腳本按正確編碼批量 UPDATE。

場景三:JDBC 讀取出來是亂碼

現象

資料庫內容正常,Java 讀出即亂碼。

核心修復:JDBC URL 明確指定字元集

jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=UTF-8&autoReconnect=true
關鍵點:
  • useUnicode=true 必須開啟。
  • characterEncoding=UTF-8 強制驅動以 UTF-8 解碼結果集。
  • **不要**設為 GB2312/GBK,驅動會雙重轉碼導致更亂。
  • Hibernate hibernate.cfg.xml 中 URL 不能含 &,需寫 &amp; 或用 CDATA。

綜合檢查清單(由前到後)

  1. JSP 頁面:<%@ page pageEncoding="UTF-8" contentType="text/html;charset=UTF-8"%>
  2. HTML Form:<form accept-charset="UTF-8">
  3. Tomcat:URIEncoding="UTF-8" 或 Filter 設定 request.setCharacterEncoding("UTF-8")
  4. Servlet/JSP 讀參數前:已由 Filter 保證編碼。
  5. JDBC URL:characterEncoding=UTF-8
  6. 資料庫/表/欄位 Collation:utf8mb4_general_ci(支援 Emoji)
  7. 響應輸出:response.setContentType("text/html;charset=UTF-8")

**全鏈路 UTF-8**,亂碼自然消失。

copyright © 萬盛學電腦網 all rights reserved