必须手动配置[client]、[mysql]、[mysqld]三段,仅改[mysqld]中character-set-server无效:[client]控制所有客户端工具默认字符集,[mysql]专用于命令行客户端,[mysqld]需同时设character-set-server、collation-server和init_connect,缺一则emoji存取或中文显示异常。

必须手动配置三段 my.cnf(或 my.ini),否则即使 MySQL 8.0 默认是 utf8mb4,客户端连上来照样乱码、存不了 emoji、甚至报 Incorrect string value 错误。
为什么只改 [mysqld] 段的 character-set-server 不行?
MySQL 启动时会读多个配置段,缺一不可。只配服务端,命令行工具(mysql)、备份工具(mysqldump)和图形客户端(如 Navicat、Workbench)仍按旧规则握手——它们不看 [mysqld],而看 [client] 和 [mysql]。
-
[client]段控制所有客户端工具的默认字符集,必须加:default-character-set = utf8mb4 -
[mysql]段专用于mysql命令行客户端,也必须加:default-character-set = utf8mb4(否则你敲mysql -u root -p进去,输入中文注释或查询含中文的字符串,立刻变问号) -
[mysqld]段至少要写三行:character-set-server = utf8mb4、collation-server = utf8mb4_0900_ai_ci、init_connect = 'SET NAMES utf8mb4'(init_connect让普通用户连接后自动生效,但对root或有SUPER权限的用户无效,需单独处理) - 别漏掉:
skip-character-set-client-handshake = OFF——设为ON会强制忽略客户端声明的charset,JDBC 或 Python 加了charset=utf8mb4也白搭
重启后怎么验证是不是真生效了?
不能只看 character_set_server。执行 SHOW VARIABLES LIKE 'character\_set%'; 后,必须确认以下五个值全为 utf8mb4:
-
character_set_client:你发的 SQL 里中文怎么被 MySQL 读(比如存储过程里的中文注释) -
character_set_connection:SQL 解析中间转换用的编码 -
character_set_database:当前库的默认字符集(建库时指定,可被ALTER DATABASE改) -
character_set_results:查出来的结果怎么返回给你(比如SELECT '你好'显示成问号就卡在这) -
character_set_server:服务端默认值,影响新建库/表
任意一个不是 utf8mb4,链路就断了。Linux 下用 sudo systemctl restart mysqld,Windows 要进服务管理器手动重启——reload 不生效。
已有数据库和表为什么还是乱码?
配置文件改完只管新库新表。老库老表字段仍是旧字符集,插入中文可能报 Incorrect string value 或存成问号。
- 先改库:
ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci; - 再改表:
ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci; - 如果报错
ERROR 1071 (42000)(索引过长),说明原VARCHAR(255)在utf8mb4下超限(4 字节 × 255 > 767 字节),得先收缩:ALTER TABLE table_name MODIFY column_name VARCHAR(191);
注意:CONVERT TO 会重写整张表,大表锁表时间长;MODIFY COLUMN 更安全,但必须重复声明类型(如 VARCHAR(255)),否则会丢失定义。
排序规则选 utf8mb4_0900_ai_ci 还是其他?
绝大多数业务场景直接用 utf8mb4_0900_ai_ci 就行——它是 MySQL 8.0 默认,基于 Unicode 9.0 标准,对重音(如 é/e)和大小写(A/a)都不敏感,能正确处理中文、西欧、阿拉伯、越南文混合排序。
- 需要严格区分大小写或重音?比如法律文书、密码校验,用
utf8mb4_0900_as_cs或显式加BINARY - 列级排序规则比表级更优先,但改列要用
MODIFY COLUMN,且必须带完整类型声明,稍不留神字段就丢了 - 改完排序规则,原有索引不会自动重建;执行
SHOW INDEX FROM users;看Collation列是否为A(表示可用),否则要手动DROP和ADD索引
最容易被忽略的是:配置文件路径是否被真正加载(mysqld --verbose --help | grep "Default options" 查找实际读取的配置路径),以及 Windows 下 my.ini 的路径分隔符要用正斜杠或双反斜杠,否则配置静默失效。











