MySQL 修改資料庫字符集教程：從 latin1 遷移到 utf8 解決中文亂碼

前言

專案升級導入資料後出現中文亂碼，排查發現資料庫、表預設字符集為 latin1，而舊資料為 utf-8 編碼。本文記錄從排查到修正的完整流程，包含服務端配置、資料庫層級、表層級的字符集統一修正。

問題現象與排查

1. 表結構檢查

SHOW CREATE TABLE clubot_members;
-- 發現：DEFAULT CHARSET=latin1

2. 系統變數檢查

SHOW VARIABLES LIKE "character%";
+--------------------------+-----------------------------+
| Variable_name            | Value                       |
+--------------------------+-----------------------------+
| character_set_client     | utf8                        |
| character_set_connection | utf8                        |
| character_set_database   | latin1  ← 問題所在          |
| character_set_filesystem | binary                      |
| character_set_results    | utf8                        |
| character_set_server     | latin1  ← 服務端預設        |
| character_set_system     | utf8                        |
| character_sets_dir       | /data/share/mysql/charsets/ |
+--------------------------+-----------------------------+

3. 資料庫建立語句確認

SHOW CREATE DATABASE clubot;
-- CREATE DATABASE `clubot` DEFAULT CHARACTER SET latin1

結論：MySQL 服務端預設 latin1，導致新建資料庫、表繼承 latin1，與 UTF-8 資料不匹配產生亂碼。

解決方案：三層級字符集統一修正

第一層：服務端配置文件（my.cnf）

編輯 /etc/mysql/my.cnf（Ubuntu 路徑，其他系統視情況調整），在 [client] 和 [mysqld] 區塊添加：

[client]
default-character-set = utf8

[mysqld]
character-set-server = utf8  # 注意：MySQL 5.5+ 廢棄 default-character-set，改用 character-set-server

踩坑記錄：初次嘗試在 [mysqld] 用 default-character-set = utf8 導致 MySQL 無法啟動，錯誤提示變量無效。查資料發現 5.5 版本服務端參數改為 character-set-server，修正後重啟成功。

第二層：資料庫層級修改

ALTER DATABASE clubot CHARACTER SET utf8;

此操作僅影響後續新建表，現有表不變。

第三層：表層級重建（關鍵步驟）

刪除亂碼表，重新導入資料（或用 ALTER TABLE ... CONVERT TO CHARACTER SET utf8 轉換）：

USE clubot;
DROP TABLE clubot_status;
DROP TABLE clubot_infos;
DROP TABLE clubot_history;
DROP TABLE clubot_members;
-- 重新導入 UTF-8 編碼的資料

完成後中文顯示正常。

關鍵知識點總結

避坑指南

1. 版本差異：MySQL 5.5+ 服務端參數從 default-character-set 改為 character-set-server
2. 層級傳遞：Server → Database → Table → Column → Connection，層層繼承，任一層不匹配即亂碼
3. 資料轉換：ALTER TABLE t CONVERT TO CHARACTER SET utf8 會實際轉換資料編碼；ALTER TABLE t CHARACTER SET utf8 僅修改表預設字符集，不轉換現有資料
4. 應用端：連線字串必須顯式指定 charset=utf8（如 mysql://root@localhost:3306/db?charset=utf8）

總結

字符集問題核心在於「編碼統一」：服務端、資料庫、表、連線四層全部設為 utf8（或 utf8mb4 支援 emoji）。新專案建議直接採用 utf8mb4 避免後續升級麻煩。已有亂碼資料庫，按本文三步驟：改配置 → 改資料庫 → 重建表/轉換表 → 重新導入資料，即可徹底解決。