MySQL 5.5.3 前 utf8 僅支援 3 字節(BMP 字符),無法存儲 Emoji 等 4 字節字符。utf8mb4 為真正的 UTF-8 超集,向下兼容並支援補充平面字符。本文提供生產環境升級全流程與驗證方法。
utf8 導致同步工具報錯或資料變亂碼utf8mb4 向下兼容 utf8,無資料遺失風險SELECT VERSION(); -- 確保 ≥ 5.5.3
編輯 /etc/my.cnf(或 my.ini):
[client]
default-character-set = utf8mb4
[mysql]
default-character-set = utf8mb4
[mysqld]
character-set-client-handshake = FALSE
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
init_connect = 'SET NAMES utf8mb4'
關鍵參數說明:
character-set-client-handshake = FALSE:強制忽略客戶端字符集請求,統一使用伺服器端設定init_connect:連線建立時自動執行 SET NAMES utf8mb4(不影響 root 等 SUPER 權限用戶)-- 資料庫層級
ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
-- 表層級(含所有欄位轉換)
ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
-- 單欄位修改(如 VARCHAR 長度需調整,因 4 字節字符佔用更多空間)
ALTER TABLE tbl_name CHANGE col_name col_name VARCHAR(191) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
注意:VARCHAR(191) 因索引長度限制(767 字節 / 4 = 191),MySQL 5.7.7+ 已放寬至 3072 字節,可用 VARCHAR(255)。
sudo systemctl restart mysqld
mysql -u root -p -e "SHOW VARIABLES WHERE Variable_name LIKE 'character\_set\_%' OR Variable_name LIKE 'collation%';"
| 變量 | 預期值 | 含義 |
|---|---|---|
| character_set_server | utf8mb4 | 預設內部操作字符集 |
| character_set_client | utf8mb4 | 客戶端來源資料字符集 |
| character_set_connection | utf8mb4 | 連線層字符集 |
| character_set_results | utf8mb4 | 查詢結果字符集 |
| character_set_database | utf8mb4 | 當前資料庫預設字符集 |
| collation_connection | utf8mb4_unicode_ci | 連線校對規則 |
| collation_database | utf8mb4_unicode_ci | 資料庫校對規則 |
| collation_server | utf8mb4_unicode_ci | 伺服器校對規則 |
character_set_system 固定為 utf8(系統元資料),不影響業務。
utf8mb4characterEncoding=utf8 即可(驅動會自動映射為 utf8mb4)character_set_client → character_set_connectioncharacter_set_connection → 內部操作字符集(欄位/表/庫/Server 級層層回退)character_set_results統一設為 utf8mb4 可避免多次轉換導致的資料損壞。
升級 utf8mb4 是現代 MySQL 應用的標配。關鍵步驟:配置檔統一設定 → 逐層轉換資料庫/表/欄位 → 重啟驗證關鍵變量 → 升級客戶端驅動。操作前務必完整備份,建議低峰期執行並安排回滾預案。