MySQL 中文亂碼終極解決方案：server/client/connection 三層編碼一致性實戰

亂碼本質：編碼不一致的三個層面

鐵律：Client = Connection = Results = Table Column，四者完全一致，零亂碼。

標準化流程：統一 utf8mb4

1. 修改 Server 預設 (永久生效)

# /etc/my.cnf / /etc/mysql/my.cnf
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4

systemctl restart mysqld

2. 修正既有庫表編碼

-- 庫
ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
-- 表 (含欄位級聯轉換)
ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 僅修改表預設，不轉換現有欄位
ALTER TABLE tbl_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

3. 連線層強制指定 (程式碼/連接池)

• JDBC：jdbc:mysql://host:3306/db?characterEncoding=utf8mb4&useSSL=false
• PHP PDO：new PDO("mysql:host=...;dbname=...;charset=utf8mb4", ...)
• Python：charset='utf8mb4' 參數
• 命令列臨時：mysql --default-character-set=utf8mb4

4. 驗證一致性

SHOW VARIABLES LIKE 'character_set_%';
SHOW VARIABLES LIKE 'collation_%';
-- 期望全部為 utf8mb4 / utf8mb4_unicode_ci

遷移舊專案：GBK/Big5 → utf8mb4 實戰步驟

1. 備份：mysqldump --default-character-set=gbk db > backup.sql
2. 建新庫 utf8mb4
3. 導入：mysql --default-character-set=utf8mb4 db < backup.sql
4. 應用層連線字串同步修改
5. 全鏈路測試：寫入 → 讀取 → 搜尋 → 匯出

常見陷阱與排查

結語

MySQL 中文亂碼 99% 來自三層編碼不一致。Server/Table/Connection 全鏈路 utf8mb4 + 統一 Collation，一次配置、永久免疫。新專案開工第一件事：SET NAMES utf8mb4 寫入基線規範。