萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL 5.x 中文亂碼完整排查與解決方案

問題根源

MySQL 5.x 預設常使用 latin1(ISO-8859-1)作為伺服器、資料庫、連線的字元集,導致中文寫入時被錯誤編碼,讀出時顯示亂碼(如 ??? 或 锟斤拷)。

三層編碼必須一致

層級設定對象推薦值
伺服器my.cnf / my.ini [mysqld] default-character-set=utf8mb4utf8mb4
資料庫/表CREATE DATABASE ... CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ciutf8mb4
連線客戶端執行 SET NAMES utf8mb4 或連線參數指定utf8mb4

解決步驟

1. 修改伺服器配置(Linux 範例)

vi /etc/my.cnf
# [mysqld] 區段新增
default-character-set=utf8mb4
character-set-server=utf8mb4
collation-server=utf8mb4_unicode_ci

# [client] 區段新增
default-character-set=utf8mb4

重啟服務:service mysqld restart

2. 驗證變數

SHOW VARIABLES LIKE 'character_set_%';

確認 character_set_server、character_set_database、character_set_client、character_set_connection、character_set_results 皆為 utf8mb4。

3. 既有資料修正

若資料已寫入錯誤編碼,需導出轉碼後再導入:

# 1. 以 latin1 導出(避免雙重轉碼)
mysqldump -uroot -p --default-character-set=latin1 dbname > backup.sql

# 2. 檔案轉碼(Linux)
iconv -f latin1 -t utf8 backup.sql > backup_utf8.sql
# 或使用 sed 將 CREATE TABLE 內的 CHARSET=latin1 改為 utf8mb4

# 3. 以 utf8mb4 導入
mysql -uroot -p --default-character-set=utf8mb4 dbname < backup_utf8.sql

4. PHP 連線設定

$pdo = new PDO("mysql:host=localhost;dbname=test;charset=utf8mb4", $user, $pass);
// 或 mysqli
$mysqli->set_charset('utf8mb4');
// 舊 mysql_* 函數(不建議使用)
mysql_query("SET NAMES 'utf8mb4'");

常見誤區

  • 僅修改資料庫預設字元集,未修改表/欄位層級 → 新表仍繼承舊編碼。
  • 使用 utf8 而非 utf8mb4 → 無法儲存 Emoji 或生僻字(utf8 實為 utf8mb3)。
  • 應用層未執行 SET NAMES → 連線層仍為 latin1,導致「存進去正常,讀出來亂碼」。
copyright © 萬盛學電腦網 all rights reserved