MySQL 插入 Emoji 報錯快速修復：僅需 ALTER TABLE CONVERT TO utf8mb4

MySQL 插入 Emoji 報錯快速修復：僅需 ALTER TABLE CONVERT TO utf8mb4

報錯信息

Incorrect string value: '\xF0\x9F\x98\x84\xF0\x9F...'

最小動作修復

ALTER TABLE 目標表 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_bin;

實測僅執行此句即解決，無需動 my.cnf（前提是服務器版本 ≥ 5.5.3 且客戶端連接字符集已正確）。

完整版操作（生產環境建議）

1. my.cnf 設置 character-set-server=utf8mb4，重啟
2. 庫/表/字段級同步改 utf8mb4
3. JDBC/連接池配置 characterEncoding=utf8mb4

原理

Emoji 佔 4 字節，MySQL utf8 只支援 3 字節；utf8mb4 為真正 UTF-8 實現。