萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

Hibernate + MySQL 中文亂碼徹底解決:資料庫、連線池、映射檔三層編碼一致性

亂碼根因

中文經過「瀏覽器 → Servlet → Hibernate → JDBC → MySQL」多層編碼/解碼,任一層不一致即產生亂碼。

三層統一編碼設定

1. 資料庫/資料表層

CREATE DATABASE mydb DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE TABLE test (...) DEFAULT CHARACTER SET utf8mb4;
  • 推薦 utf8mb4(支援 Emoji、完整 Unicode),而非舊版 utf8(僅 3 字節)。
  • 舊專案若必須用 gb2312,請全鏈路統一為 gb2312。

2. JDBC 連線字串

jdbc:mysql://localhost:3306/mydb?useUnicode=true&characterEncoding=utf8mb4&zeroDateTimeBehavior=convertToNull&serverTimezone=Asia/Taipei
  • useUnicode=true 啟用 Unicode 傳輸。
  • characterEncoding=utf8mb4 指定連線編碼。
  • MySQL 8.0+ 需 serverTimezone 避免時區警告。

3. Hibernate 設定

<property name="hibernate.connection.CharSet">utf8mb4</property>
<property name="hibernate.connection.characterEncoding">utf8mb4</property>
<property name="hibernate.connection.useUnicode">true</property>

或在 hibernate.cfg.xml 的 session-factory 內加入上述屬性。

驗證清單

  1. 資料庫/表/欄位 `CHARACTER SET` 皆為 utf8mb4。
  2. 連線字串含 `characterEncoding=utf8mb4`。
  3. Hibernate 設定同步。
  4. Java 原始碼檔案儲存為 UTF-8(IDE 設定)。
  5. 頁面 ``、Servlet `request.setCharacterEncoding("UTF-8")`、`response.setContentType("text/html;charset=UTF-8")`。

常見誤區

  • 以為只設資料庫編碼就夠 → JDBC 連線編碼未指定,驅動預設 latin1 導致寫入錯誤。
  • 使用 `new String(bytes, "ISO-8859-1")` 強制轉碼 → 掩蓋症狀,資料庫實際存儲已錯誤。
  • MySQL 5.7 以前 `utf8` 實為 `utf8mb3`,無法存 Emoji,升級請全面遷移至 `utf8mb4`。
copyright © 萬盛學電腦網 all rights reserved