Hibernate 連接 MySQL 中文亂碼終極解決方案

Hibernate 連接 MySQL 中文亂碼終極解決方案

在 Java 應用整合 MySQL 時，中文亂碼是高頻痛點。即使資料庫、應用均設為 UTF-8，若 JDBC 連線參數缺失，Hibernate 寫入資料時仍會出現亂碼。本文給出標準解決姿勢。

核心解決：JDBC URL 必加雙參數

jdbc:mysql://localhost:3306/your_db?useUnicode=true&characterEncoding=utf8

• useUnicode=true：啟用 Unicode 字符集支援。
• characterEncoding=utf8：明確指定連線傳輸編碼為 UTF-8（MySQL 內部為 utf8mb4 時亦建議寫 utf8，驅動會自動映射）。

XML 配置檔轉義陷阱

在 hibernate.cfg.xml 或 Spring dataSource Bean 定義中，& 必須轉義為 &：

<property name="connection.url">
    jdbc:mysql://localhost:3306/fdoa?useUnicode=true&amp;characterEncoding=utf8
</property>

若直接寫 &，XML 解析器會報錯或參數失效，導致編碼不生效。

完整驗證清單

進階：支援 Emoji 與補充字符

MySQL 5.5.3+ 引入 utf8mb4（真正的 UTF-8），若需儲存 Emoji：

1. 資料庫/表/欄位全鏈路設為 utf8mb4。
2. JDBC URL 改為：characterEncoding=utf8mb4（Connector/J 5.1.13+ 支援）或保持 utf8（驅動自動升級）。
3. 連線池屬性加入：connectionInitSql=SET NAMES utf8mb4（HikariCP/Druid 支援）。

常見誤區

• ❌ 僅設 SET NAMES utf8：僅影響當前 Session，連線池重用時失效。
• ❌ 以為 characterEncoding=UTF-8（含連字號）：MySQL 驅動識別 utf8，連字號會被忽略。
• ❌ 忽略 XML 轉義：導致參數實際未傳遞給驅動。

1. 上一篇文章： MySQL 日誌完整指南：啟用、查看、二進制日誌恢復實戰
2. 下一篇文章： MySQL 二進制日誌恢復實戰：mysqlbinlog 完整操作指南

MySQL 綜合教學

MySQL 建表全流程實戰：從登錄到插入查詢的完整指南

MySQL 數據庫建表與數據操作入門實戰 本文以圖文並茂形式

MySQL 5.7 ZIP 包 Windows 免安裝部署極速指南

MySQL 5.7 ZIP 包 Windows 免安裝部署極

MySQL NULL 值處理兩大陷阱：TIMESTAMP 默認值與空值判斷

MySQL 中 NULL 處理存在兩大反直覺陷阱：TIMES

MySQL 連接失敗？排查 Can't connect to MySQL server (2002/2003) 完整指南

錯誤代碼速查 錯誤碼含義常見原因 2002Cant