DIV CSS 佈局教程網

Hibernate 搭配 MySQL 出現中文亂碼的處理方式
編輯:JavaScript綜合知識     

Hibernate 接 MySQL 時的中文亂碼,幾乎都是同一個原因:資料庫、資料表、連線三層的編碼不一致。逐一對齊就能解決。

步驟一:讓資料表使用正確的編碼

若系統是 Windows,預設本地字元集通常是 gb2312/GBK,那麼建立資料表時就要明確指定:

CREATE TABLE TEST
{
   ...
   ...
}
default character set gb2312;

步驟二:讓 Hibernate 連線使用相同編碼

在 hibernate.cfg.xml 中加上連線編碼參數:

<property name="connection.characterEncoding">gb2312</property>

如果是 Linux 系統,把上面兩處的 gb2312 換成 UTF8 即可。

為什麼要三層一致

中文在傳輸鏈路上會經過:應用程式 → JDBC 連線 → MySQL 伺服器 → 資料表/欄位。任何一層的編碼與其他層不同,就會在那個節點發生位元組被錯誤解讀的情形。這也是為什麼只改資料表編碼、卻沒改連線編碼時,亂碼依然存在。

更完整的排查清單

1. 伺服器層級:MySQL 的 my.ini/my.cnf 中設定 [mysqld] character-set-server=utf8 與 collation-server=utf8_general_ci,並確認 default-character-set 也一致。

2. 資料庫與資料表層級:建庫時用 CREATE DATABASE dbname DEFAULT CHARACTER SET utf8 COLLATE utf8_general_ci;既有資料表可用 ALTER TABLE tbl CONVERT TO CHARACTER SET utf8 批次轉換。

3. JDBC 連線層級:URL 上明確帶上編碼參數,比只設定 Hibernate 屬性更保險:

jdbc:mysql://localhost:3306/dbname?useUnicode=true&characterEncoding=UTF-8

4. 應用層級:Servlet 容器與 Spring 都要一併設定,例如 request.setCharacterEncoding("UTF-8")、response 的 Content-Type 帶 charset、以及 ServletContext 或 connector 的 URIEncoding。

5. JVM 層級:啟動參數加上 -Dfile.encoding=UTF-8,避免讀寫檔案時又回到平台預設編碼。

關於 utf8 與 utf8mb4

MySQL 的 utf8 其實是「每字元最多 3 位元組」的精簡實作,無法儲存 emoji 與部分罕用漢字(擴充 B 區以上)。若系統需要完整支援 Unicode,建議直接使用 utf8mb4 搭配 utf8mb4_general_ci 或 utf8mb4_unicode_ci,並確認 MySQL 版本與連線函式庫都支援。

另外,若已經寫入資料才發現亂碼,單純改編碼設定並不會自動修正既有內容,需要匯出為原始位元組後重新以正確編碼匯入,才能還原。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved