必须同时配置my.cnf的[client]、[mysql]、[mysqld]三段并重启验证，缺一不可；已有库表需手动alter；连接与应用层也需显式指定charset=utf8mb4。

MySQL里配utf8mb4不是改一个参数就完事，必须客户端、连接层、服务端、表结构四层全部对齐，漏一层都存不了emoji，查出来也是乱码或Incorrect string value错误。

my.cnf 必须同时写[client]、[mysql]、[mysqld]三段

只在[mysqld]里写character-set-server = utf8mb4是无效的。MySQL启动时分段读取配置，每段控制不同环节：

• [client]加default-character-set = utf8mb4：影响mysqldump、mysqladmin等所有客户端工具
• [mysql]加default-character-set = utf8mb4：专用于mysql命令行客户端自身（不写可能被忽略）
• [mysqld]加character-set-server = utf8mb4和collation-server = utf8mb4_0900_ai_ci（MySQL 8.0+）或utf8mb4_unicode_ci（5.7）：决定新库/新表默认值

Docker环境要确认挂载的my.cnf权限是644，否则mysqld会静默跳过；Windows用户路径通常是C:\ProgramData\MySQL\MySQL Server X.X\my.ini。

重启后必须验证6个关键变量全为utf8mb4

改完配置不验证，等于没改。登录后立即执行：

SHOW VARIABLES LIKE 'character\_set%';<br>SHOW VARIABLES LIKE 'collation%';

以下6项必须全为utf8mb4或对应utf8mb4_*排序规则：

• character_set_client
• character_set_connection
• character_set_database
• character_set_results
• character_set_server
• collation_server

Linux下用mysql -u root -p登录后若STATUS;显示via socket，说明[client]段可能未生效——改用mysql -h 127.0.0.1 -u root -p强制走TCP再查。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

已有数据库和表不会自动升级，必须手动ALTER

character-set-server只影响新建对象，老库老表字段仍保持原字符集，DESCRIBE table_name看不出异常，但插入emoji必报错。

• 改库：ALTER DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;
• 改表（重建）：ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;——注意大表会锁表
• 改字段（更安全）：ALTER TABLE tbl_name MODIFY column_name VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

如果执行CONVERT TO时报Specified key was too long，说明索引超长（utf8mb4下VARCHAR(255) × 4 = 1020 > 767），临时解法是把字段缩到VARCHAR(191)；根治需启用innodb_large_prefix=ON并设ROW_FORMAT=DYNAMIC。

应用连接层不指定charset=utf8mb4，前面全白干

服务端、库、表全对，但PHP、Python、Java这些客户端没声明字符集，MySQL仍按默认（常为latin1）解析字节流，emoji进来就是问号或截断。

• PHP PDO：mysql:host=localhost;dbname=test;charset=utf8mb4
• Python pymysql：charset='utf8mb4'传入connect()
• Node.js mysql2：{ charset: 'utf8mb4' }
• JDBC：jdbc:mysql://host:3306/db?useUnicode=true&characterEncoding=utf8mb4（Connector/J ≥ 5.1.13）

特别注意：init_connect = 'SET NAMES utf8mb4'可辅助新连接，但对root@localhost这类高权限账户默认不生效，测试时建议用普通用户。

最容易被忽略的是字段级字符集——即使表默认设了utf8mb4，某个VARCHAR字段建表时没显式声明，它就继承数据库甚至服务器的旧设置，而这种差异在SHOW CREATE TABLE里一眼就能看出，但很多人只扫一眼表名就过了。