根本原因是mysql的utf8实为utf8mb3(仅支持3字节),无法存储4字节中文及emoji;必须client、connection、server、database、table、column六层字符集全部统一为utf8mb4,缺一不可。

MySQL安装后无法插入中文,根本不是“没开UTF8”,而是 utf8mb4 没配全——client、connection、server、database、table、column 六处缺一不可,任意一层是 latin1 或 utf8(即 utf8mb3),都会在某环节把中文切成乱码或直接报 Incorrect string value。
查清当前字符集实际值,别猜配置文件有没有生效
进 MySQL 执行:SHOW VARIABLES LIKE 'character\_set%';
重点盯这三项是否全为 utf8mb4:
- character_set_client:你发的 SQL 是按什么编码读的(比如终端是 GBK,但这里显示 utf8mb4,就说明终端和 MySQL 解码已对齐)
- character_set_connection:SQL 在服务端内部转码用的中间层,必须和 client 一致,否则会二次解错
- character_set_results:SELECT 返回结果时用的编码,影响客户端显示
常见错误:前三项里混着 latin1 或 utf8(即 utf8mb3),哪怕只有一处不一致,插入中文就会丢字节或变问号
改配置文件必须覆盖 [client]、[mysql]、[mysqld] 三段
Linux 下编辑 /etc/mysql/my.cnf,Windows 下改 my.ini,只加这三段,旧写法如 default-character-set 在 [mysqld] 下已废弃:
[client]<br>default-character-set = utf8mb4<br><br>[mysql]<br>default-character-set = utf8mb4<br><br>[mysqld]<br>character-set-server = utf8mb4<br>collation-server = utf8mb4_unicode_ci
注意:
utf8mb4_unicode_ci 比 utf8mb4_general_ci 对中文排序更准,推荐优先用;改完必须重启 MySQL(sudo service mysql restart 或 Windows 下 net stop mysql && net start mysql),否则配置只是摆设已有数据库和表必须手动升级到 utf8mb4
配置文件改了只影响新建库/表,老数据不会自动转换:
- 改库:ALTER DATABASE your_db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
- 改表(重建方式,大数据量慎用):ALTER TABLE your_table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
- 更安全的列级修改(需重写字段定义):ALTER TABLE your_table_name MODIFY column_name VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
验证是否真改成功:SHOW CREATE TABLE your_table_name; 输出里必须同时出现 DEFAULT CHARSET=utf8mb4 和列定义带 COLLATE utf8mb4_unicode_ci,光有 CHARACTER SET utf8mb4 不够,漏掉 COLLATE 会隐式降级
应用连接时必须显式指定 charset,不能依赖 SET NAMES
SET NAMES utf8mb4 只对当前连接有效,断开就失效,且很多 ORM 默认不发这条命令:
- Python pymysql:pymysql.connect(..., charset='utf8mb4')
- Node.js mysql2:charset: 'utf8mb4' 写进连接配置对象
- PHP mysqli:连接后立刻执行 $mysqli->query("SET NAMES utf8mb4")
- 命令行 mysql 客户端:启动时加 --default-character-set=utf8mb4,比登录后再 SET 更可靠
漏掉这一层,哪怕服务端全配对了,应用发来的 4 字节 emoji 还是会被当成非法序列截断
最容易被忽略的是:MySQL 的 utf8 不是标准 UTF-8,它最多只支持 3 字节,而微信昵称、生僻汉字、“?”这类字符需要 4 字节 —— 所以只要数据里含这些,utf8 就必然失败,必须用 utf8mb4,且六层(client/connection/results/server/database/table/column)全部对齐,少一处都不行。











