萬盛學電腦網

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

MySQL 存儲 Emoji 表情符號完全指南:從 utf8 到 utf8mb4 的遷移實戰

為什麼 utf8 存不了 Emoji?

MySQL 所謂的 utf8 實為 utf8mb3,最多 3 位元組/字元,僅覆蓋 BMP(基本多文種平面)。Emoji 位於輔助平面(代碼點 ≥ U+10000),需 4 位元組編碼,直接寫入會報錯:

Incorrect string value: '\xF0\x9F\x98\x84...' for column 'content'

徹底解決:全鏈路升級到 utf8mb4

1. 資料庫/表/欄位層級轉換

-- 資料庫級
ALTER DATABASE `dbname` CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

-- 表級(含所有字串欄位)
ALTER TABLE `t1` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 單欄位(若表已轉換,單欄通常無需再改)
ALTER TABLE `t1` MODIFY `content` VARCHAR(500) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
  • CONVERT TO 會重建表並轉換現有數據,utf8 → utf8mb4 無損。
  • 排序規則推薦 utf8mb4_unicode_ci(準確排序)或 utf8mb4_0900_ai_ci(8.0+,支援加權排序)。

2. 連接層指定字元集

應用程式連接字串/配置必須顯式設定:

# JDBC
jdbc:mysql://host:3306/db?characterEncoding=utf8mb4&useUnicode=true

# PHP PDO
$pdo = new PDO("mysql:host=...;dbname=...;charset=utf8mb4", $user, $pass);

# Python PyMySQL
conn = pymysql.connect(..., charset='utf8mb4')

# Go sqlx
db, _ = sqlx.Open("mysql", "user:pass@tcp(host:3306)/db?charset=utf8mb4&parseTime=true")

驗證:SHOW VARIABLES LIKE 'character_set_%'; 客戶端、連接、結果集均為 utf8mb4。

3. 伺服器配置固化

[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'   -- 非超級用戶自動生效

無法升級時的降級方案:過濾 4 位元組字元

若受限於舊框架/中介軟體無法升級,入庫前剔除 Emoji:

-- PHP 正則過濾(推薦)
$str = preg_replace('/[\xF0-\xF7][\x80-\xBF]{3}/', '', $str);

-- 或 Unicode 碼點範圍(較慢)
$str = preg_replace('/[\x{10000}-\x{10FFFF}]/u', '', $str);
  • 第一種利用 UTF-8 編碼規則:4 位元組序列首位元組固定為 0xF0~0xF7。
  • 第二種直接匹配碼點範圍,需 u 修飾符啟用 UTF-8 模式。

驗證清單

  1. 資料庫/表/欄位均為 utf8mb4。
  2. 應用連接字串含 charset=utf8mb4。
  3. 終端機/客戶端工具支援 Emoji 顯示(如 mysql CLI 執行 SET NAMES utf8mb4)。
  4. 寫入/讀出測試:INSERT ... VALUES ('😀🎉') → SELECT HEX(content) 應見 F09F9880F09F8E89。

總結

Emoji 存儲的核心是「全鏈路 utf8mb4」。MySQL 5.5.3+ 完整支援,5.7/8.0 更優化了索引長度限制(innodb_large_prefix 預設開啟)。無特殊理由,新專案直接採用 utf8mb4,舊專案按上述步驟遷移,一次到位。

copyright © 萬盛學電腦網 all rights reserved