MySQL 導入腳本文件顯示亂碼解決：SET NAMES、客戶端字符集、文件編碼三層一致性原則

現象

mysql> source /path/to/backup.sql;
-- 或
mysql -uroot -p < backup.sql
-- 導入後中文顯示亂碼：????、、錯誤字符

根因：三層編碼不一致

1. SQL 文件物理編碼：文件保存時的編碼 (UTF-8 / GBK / GB2312)。
2. MySQL 客戶端連接字符集：`SET NAMES charset` / `--default-character-set`。
3. 目標表/列字符集：`CHARACTER SET utf8mb4` / `gbk`。

**鐵律：** 文件編碼 = 連接字符集 = 目標字符集 (或隱式轉換無損)。

即時解決：導入前 SET NAMES

mysql> SET NAMES gbk;          -- 若文件是 GBK 編碼
mysql> SOURCE /path/to/backup.sql;

-- 或命令行指定
mysql --default-character-set=gbk -uroot -p < backup.sql

文件編碼檢測與轉換

# Linux 檢測
file backup.sql
# 輸出: UTF-8 Unicode text / ISO-8859 text (GBK 常被誤判)

# 確認含中文行
head -n 20 backup.sql | cat -A

# 轉換 (iconv)
iconv -f GBK -t UTF-8 backup.sql > backup_utf8.sql
iconv -f UTF-8 -t GBK backup_utf8.sql > backup_gbk.sql

永久配置：my.cnf 統一字符集

[client]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4

[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
init_connect = 'SET NAMES utf8mb4'

重啟服務生效。新連接自動 `SET NAMES utf8mb4`，UTF-8 文件無需手動指定。

避坑清單

最佳實踐

1. **全鏈路 utf8mb4**：文件、連接、庫、表、列、應用、前端。
2. **導出指定字符集**：`mysqldump --default-character-set=utf8mb4`。
3. **導入指定字符集**：`mysql --default-character-set=utf8mb4 < dump.sql`。
4. **驗證**：導入後 `SELECT HEX(col), col FROM tbl LIMIT 1;` 檢查十六進制編碼正確性。