MySQL 8.0存Emoji需全链路utf8mb4：必须同步配置my.cnf中[mysqld]（character-set-server、collation-server、init_connect）、[client]和[mysql]段的default-character-set，且表、字段、连接参数（如JDBC的charset=utf8mb4）均需显式设为utf8mb4，任一环节缺失都会导致Incorrect string value错误。
MySQL 8.0 默认 character_set_server 确实是 utf8mb4，但这只是起点——Emoji 存不进去，99% 的情况是因为连接层、表结构、字段定义三处没对齐，不是“改个配置就完事”。
my.cnf 必须同步配齐三项，缺一不可
只写 character-set-server=utf8mb4 是最常见错误。MySQL 启动后服务端字符集虽对了，但客户端连接协商、会话初始化、排序规则仍可能 fallback 到旧值。
在 [mysqld] 段必须同时设置：
-
character-set-server=utf8mb4：影响新建库/表的默认字符集 -
collation-server=utf8mb4_0900_ai_ci：MySQL 8.0 推荐 collation，不显式写可能退化为已弃用的utf8mb4_general_ci -
init_connect='SET NAMES utf8mb4'：让普通用户（非 root）连接时自动切换会话字符集；root 用户不受此影响，需手动执行SET NAMES utf8mb4
另外，[client] 和 [mysql] 段也要补上 default-character-set=utf8mb4，否则本地 mysql 命令行工具仍可能用 latin1 解析输入。
SHOW VARIABLES LIKE 'character\_set%' 必须全为 utf8mb4
登录 MySQL 后执行这条命令，重点盯住这 6 项：
character_set_clientcharacter_set_connectioncharacter_set_databasecharacter_set_resultscharacter_set_servercollation_server
任意一项是 utf8（即 utf8mb3）或 latin1，说明链路断在某一层。常见现象包括：mysql 命令行输中文显示问号、Python pymysql 报错 2059、Navicat 插入 emoji 失败。
如果 character_set_client 是 utf8，大概率是客户端连接串没声明 charset=utf8mb4，或 init_connect 没生效（比如 root 用户未手动执行 SET NAMES utf8mb4）。
ALTER TABLE CONVERT TO CHARACTER SET utf8mb4 容易卡在索引长度
执行 ALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 时，报 Specified key was too long 是高频错误。
原因很直接：VARCHAR(255) 加索引 → 255 × 4 字节 = 1020 > InnoDB 默认索引键长上限 767 字节。
临时解法：
- 把索引字段缩到
VARCHAR(191)（191 × 4 = 764，安全）
根治法（推荐）：
- 确认并启用：
innodb_file_format=Barracuda、innodb_file_per_table=ON、innodb_large_prefix=ON - 建表或转换时显式指定：
ROW_FORMAT=DYNAMIC
注意：TEXT 类型字段不会随 CONVERT 自动升级，必须单独执行：MODIFY COLUMN content TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci。
应用连接串必须显式声明 charset=utf8mb4
即使服务端、库、表、字段全设成 utf8mb4，只要连接串没声明字符集，前面全白干。
各语言典型写法：
- JDBC：
jdbc:mysql://host:3306/db?useUnicode=true&characterEncoding=utf8mb4（MySQL Connector/J ≥ 5.1.13） - PHP PDO：
mysql:host=localhost;dbname=test;charset=utf8mb4 - Node.js mysql2：
{ charset: 'utf8mb4' } - Django：
OPTIONS={'charset': 'utf8mb4'}，ORM 不继承数据库全局设置，必须显式写
特别注意：不要在连接后执行 SET NAMES utf8 或 SET character_set_client=latin1 这类覆盖操作，会直接覆盖掉 init_connect 的效果。
最容易被忽略的是老表老字段——它们不会因为改了 character_set_server 就自动升级。哪怕数据里已经存了 emoji，查询时仍可能显示乱码或报错，必须逐层检查并显式修改数据库、表、字段的字符集定义。
