MySQL 8.0 不再推荐使用 utf8,因其实际为 utf8mb3,仅支持最多3字节编码,无法存储 emoji 等需4字节的 Unicode 字符(如 U+1F60A),导致 Incorrect string value 错误;官方自 8.0.28 起已将其标记为弃用,必须统一使用 utf8mb4 及配套 collation(如 utf8mb4_0900_ai_ci)并确保客户端、连接、服务端、表、列五层字符集对齐。

MySQL 8.0 不再推荐使用 utf8,是因为它根本不是真正的 UTF-8 —— 它最多只支持 3 字节编码,连常见 Emoji(如 ?)都会触发 Incorrect string value 错误,这不是配置问题,是设计限制。
为什么 utf8 在 MySQL 里存不了 ?
MySQL 的 utf8 是历史别名,实际等价于 utf8mb3,只覆盖 Unicode 基本多文种平面(BMP,U+0000–U+FFFF)。而 ? 对应 U+1F60A,落在辅助平面,需 4 字节 UTF-8 编码 \xF0\x9F\x98\x8A。服务端看到这串字节直接拒绝写入。
-
SHOW CHARSET LIKE 'utf8'显示Maxlen = 3,不是 4 - MySQL 8.0.28 起,
utf8已被官方标记为「已弃用」 - 即使客户端、连接、表都设成
utf8,插入四字节字符仍必报错或静默转成?
utf8mb4 生效必须五层对齐
只改 character_set_server = utf8mb4 不代表 Emoji 就能入库。漏掉任一环节,都会在 INSERT 或 JOIN 时失败:
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 客户端配置缺失:
[client]和[mysql]段没加default-character-set = utf8mb4,命令行工具仍按utf8解码 - 连接握手被绕过:JDBC 连接串含
characterEncoding=utf8,会覆盖服务端设置;必须用useUnicode=true&characterEncoding=utf8mb4 - 已有对象未升级:老表的
CHARACTER SET和COLLATION仍是utf8或latin1,需显式执行ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci - 索引长度超限:
VARCHAR(255)在utf8mb4下理论占 1020 字节,超 InnoDB 默认 767 字节上限;需确保innodb_large_prefix = ON且ROW_FORMAT = DYNAMIC
utf8mb4_0900_ai_ci 是默认排序规则,但老表不会自动升级
MySQL 8.0 中,character_set_server = utf8mb4 会硬绑定默认 collation_server 为 utf8mb4_0900_ai_ci,但这个规则只对新创建的库/表/列生效。
-
collation_server是只读变量,运行时设了会报错:Variable 'collation_server' is a read only variable - 老表仍保持
utf8mb4_general_ci或utf8mb4_unicode_ci,跨表JOIN或ORDER BY时可能触发Illegal mix of collations - 验证方法:
SHOW FULL COLUMNS FROM table_name看Collation列是否统一 - 修复方式:逐字段
MODIFY并指定COLLATE utf8mb4_0900_ai_ci,大表注意锁和耗时
最常被忽略的是连接层 —— 表结构全改成 utf8mb4,只要 JDBC 连接串没声明 charset=utf8mb4,或者驱动版本低于 5.1.13,照样报错。这不是“配得不够”,是 MySQL 在连接握手阶段就按错误字符集解码了。










