MySQL 升級 utf8mb4 全鏈路實戰：支持 Emoji 表情、解決「Incorrect string value」

全鏈路升級清單 (缺一不可)

1. 數據庫服務端配置 (/etc/my.cnf)

-- 庫級
ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

-- 表級 (含數據轉換，大表必須用 pt-osc/gh-ost)
ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 僅修改表默認字符集 (不轉換現有列數據，慎用)
ALTER TABLE tbl_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;

-- 列級檢查 (確認無殘留 utf8 列)
SELECT TABLE_SCHEMA, TABLE_NAME, COLUMN_NAME, CHARACTER_SET_NAME, COLLATION_NAME
FROM information_schema.COLUMNS
WHERE TABLE_SCHEMA = 'db_name' AND CHARACTER_SET_NAME != 'utf8mb4';

3. 應用端連接配置 (Java/JDBC 為例)

-- 1. 會話級驗證
SHOW VARIABLES LIKE '%character%';
-- 關鍵項均為 utf8mb4

-- 2. 實測插入 Emoji
CREATE TABLE emoji_test (c VARCHAR(10) CHARACTER SET utf8mb4) ENGINE=InnoDB;
INSERT INTO emoji_test VALUES ('😀'), ('🎉'), ('🚀'), ('💯');
SELECT c, HEX(c), CHAR_LENGTH(c), LENGTH(c) FROM emoji_test;
-- HEX: F09F9880 (4 字節), CHAR_LENGTH=1, LENGTH=4

-- 3. 應用端插入驗證 (Java)
String sql = "INSERT INTO emoji_test VALUES (?)";
try (PreparedStatement ps = conn.prepareStatement(sql)) {
    ps.setString(1, "😎👍");
    ps.executeUpdate();
}

常見陷阱與解決

排序規則選型建議

• utf8mb4_unicode_ci：基於 UCA 9.0.0，準確性高，支持多語言排序規則，通用首選。
• utf8mb4_0900_ai_ci (8.0+)：UCA 9.0.0 + AI (Accent Insensitive) + CI，性能更好、功能更強，新項目首選。
• utf8mb4_general_ci：舊版簡化規則，不準確 (如德語 ß、法語 à)，**不推薦新項目使用**。

總結

MySQL 支持 Emoji 的本質是 **全鏈路 utf8mb4**：
Server 配置 → 庫表列轉換 → 連接池/驅動 → 應用代碼 → 客戶端工具，缺一環即失效。
新項目**直接初始化 utf8mb4**，存量項目按「庫 → 表 → 列」分批遷移，**大表必走 pt-osc/gh-ost**。
將字符集治理納入架構治理體系，定期掃描 information_schema.COLUMNS 發現非 utf8mb4 列自動工單修復。