萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 資料庫 >> MySQL 教學

MySQL 5.5.3+ 支持 Emoji 存儲:utf8mb4 升級遷移完整方案

為什麼 utf8 存不下 Emoji?

  • MySQL utf8 實為 utf8mb3,最大 3 字節/字符。
  • Emoji 屬於 Unicode 輔助平面,編碼需 4 字節(如 😀 = \xF0\x9F\x98\x80)。
  • 3 字節截斷導致存儲失敗或數據截斷。

解決方案對比

方案前提優點缺點
升級 utf8mb4MySQL ≥ 5.5.3原生支持、無業務代碼改動、索引可用需變更庫表、索引長度限制
Base64 編碼存儲任意版本不改動數據庫佔用空間 +33%、失去索引/搜索、讀寫需編解碼

強烈推薦方案一,一勞永逸。


utf8mb4 遷移步驟(零停機方案)

1. 服務端配置 my.cnf

[client]
default-character-set=utf8mb4

[mysqld]
character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
init_connect='SET NAMES utf8mb4'
skip-character-set-client-handshake

重啟 MySQL。

2. 資料庫級遷移

ALTER DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

3. 表級遷移(核心、耗時最長)

-- 逐表執行,大表建議維護窗口或用 pt-online-schema-change
ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

⚠️ CONVERT TO 會重建表並轉換數據;CHARACTER SET 僅修改默認值,不轉換現有數據。

4. 索引長度調整(大表必做)

-- 檢查超長索引
SELECT TABLE_NAME, COLUMN_NAME, CHARACTER_MAXIMUM_LENGTH 
FROM INFORMATION_SCHEMA.COLUMNS 
WHERE TABLE_SCHEMA='db_name' AND CHARACTER_SET_NAME='utf8mb4' AND CHARACTER_MAXIMUM_LENGTH > 191;

-- 方案 A:縮短字段長度(如 VARCHAR(255) → VARCHAR(191))
-- 方案 B:啟用大前綴(需 5.7.7+ / 5.6.20+)
SET GLOBAL innodb_large_prefix=ON;
SET GLOBAL innodb_file_format=Barracuda;
ALTER TABLE table_name ROW_FORMAT=DYNAMIC;  -- 或 COMPRESSED

5. 應用層連接字符串同步修改

參考上篇文章「應用層連接字符串」節。


驗證測試

INSERT INTO test_table (col) VALUES ('😀🚀🎉');
SELECT col, HEX(col), CHAR_LENGTH(col) FROM test_table;
-- 應正確顯示 Emoji、HEX 為 4 字節序列、長度為 3

版本兼容性提醒

  • MySQL 5.5.3 - 5.6.x:需手動啟用 innodb_large_prefix + Barracuda 文件格式。
  • MySQL 5.7.7+ / 8.0+:默認 innodb_large_prefix=ON、ROW_FORMAT=DYNAMIC,無額外配置。
  • MariaDB 10.2.2+ 同 5.7 行為。
copyright © 萬盛學電腦網 all rights reserved