必须将表和字段字符集均改为utf8mb4才能支持Emoji等4字节UTF-8字符,因MySQL的utf8仅支持3字节编码;需同步修改服务端配置、连接参数及字段级字符集,并实测验证。

必须把表和字段的字符集都改成 utf8mb4,只改数据库默认字符集或只改表不改字段,90% 的情况仍然会报 Incorrect string value 错误。
为什么 utf8 不行,非得用 utf8mb4?
MySQL 的 utf8 实际上是“伪 UTF-8”,最多只支持 3 字节编码,而 Emoji(如 ?、?、??)需要 4 字节 UTF-8 编码。从 MySQL 5.5.3 开始才正式支持 utf8mb4,它才是真正的 UTF-8 实现。
-
utf8:最大 3 字节,不支持 Emoji、部分中文生僻字、数学符号 -
utf8mb4:完整 UTF-8,兼容所有 Unicode 字符 - 即使客户端连接用了
utf8mb4,只要字段本身仍是utf8,插入时仍会截断或报错
如何检查并修改现有表字段的字符集?
不能只看 SHOW CREATE TABLE 的输出表面——要逐个确认字段定义里的 CHARACTER SET 和 COLLATE。常见陷阱是表默认字符集已改,但字段仍继承旧的 utf8。
- 查字段实际字符集:
SELECT COLUMN_NAME, CHARACTER_SET_NAME, COLLATION_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = 'your_db' AND TABLE_NAME = 'your_table' AND DATA_TYPE IN ('varchar', 'text', 'mediumtext', 'longtext'); - 批量改字段(示例改
content字段):ALTER TABLE your_table MODIFY content TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; -
VARCHAR字段长度超过 191 且使用utf8mb4时,索引可能失效(因 InnoDB 单索引长度限制为 767 字节),需配合innodb_large_prefix=ON或改用前缀索引
服务端配置和连接参数缺一不可
只改表结构,不配服务端和客户端,依然会出问题。MySQL 会按连接层字符集做转换,中间任一环节是 utf8 都可能丢数据。
- my.cnf 中必须包含:
[client] default-character-set = utf8mb4、[mysqld] character-set-server = utf8mb4、collation-server = utf8mb4_unicode_ci - 重启 MySQL 后验证:
SHOW VARIABLES LIKE 'character_set%';和SHOW VARIABLES LIKE 'collation%';全部应为utf8mb4 - 应用连接字符串里必须显式指定字符集,例如 JDBC:
?useUnicode=true&characterEncoding=utf8mb4;PHP PDO:charset=utf8mb4在 DSN 中 - Node.js mysql2 模块需设
charset: 'utf8mb4',否则即使服务端正确,驱动仍可能用utf8发送
最容易被忽略的是字段级字符集——哪怕整个库、表都设对了,一个 TEXT 字段还是 utf8,插 Emoji 就会立刻失败。改完务必用 INSERT INTO ... VALUES ('?'); 实测,别只看配置就认为搞定了。


















