MySQL 5.x 預設常使用 latin1(ISO-8859-1)作為伺服器、資料庫、連線的字元集,導致中文寫入時被錯誤編碼,讀出時顯示亂碼(如 ??? 或 锟斤拷)。
| 層級 | 設定對象 | 推薦值 |
|---|---|---|
| 伺服器 | my.cnf / my.ini [mysqld] default-character-set=utf8mb4 | utf8mb4 |
| 資料庫/表 | CREATE DATABASE ... CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci | utf8mb4 |
| 連線 | 客戶端執行 SET NAMES utf8mb4 或連線參數指定 | utf8mb4 |
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
SHOW VARIABLES LIKE 'character_set_%';
確認 character_set_server、character_set_database、character_set_client、character_set_connection、character_set_results 皆為 utf8mb4。
若資料已寫入錯誤編碼,需導出轉碼後再導入:
# 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
$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,導致「存進去正常,讀出來亂碼」。