根本原因是表或列字符集为utf8mb3而非utf8mb4,因utf8mb3仅支持3字节unicode,而emoji及部分生僻中文需4字节;须同步修改服务端配置、表/列字符集与校对规则、应用连接参数。

MySQL 插入中文报错 Incorrect string value
根本原因是表或列的字符集不是 utf8mb4,而是旧版 utf8(即 utf8mb3)。MySQL 的 utf8 实际只支持最多 3 字节的 Unicode 字符,而 emoji 和部分生僻中文(如「?」「?」)需要 4 字节,必须用 utf8mb4。
常见错误现象:
- 执行
INSERT含 emoji 或某些中文时报Incorrect string value: '\xF0\x9F\x98\x82' for column 'name' - 中文显示成问号(
???)或空格,但无报错(说明客户端能传,但服务端存不全)
实操建议:
- 不要只改数据库(
ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;),必须同步改表和列 - 用
SHOW CREATE TABLE table_name;确认当前字符集,重点看DEFAULT CHARSET和各TEXT/VARCHAR列的COLLATE - 修改列时需显式指定字符集与校对规则:
ALTER TABLE user MODIFY name VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
my.cnf 配置里 character-set-server 不生效?
即使在 [mysqld] 段写了 character-set-server = utf8mb4,新创建的库/表仍可能用 latin1 或 utf8,因为客户端连接时没带编码声明,或配置未覆盖全部环节。
实操建议:
- 确认配置文件路径正确(
mysql --help | grep "Default options"查找加载顺序),重启 MySQL 服务(systemctl restart mysql或service mysqld restart) - 必须同时设置
collation-server = utf8mb4_unicode_ci,否则默认校对规则仍可能不匹配 - 在
[client]和[mysql]段也加default-character-set = utf8mb4,避免命令行客户端连上去就用错编码 - 检查运行时变量:
SHOW VARIABLES LIKE 'character_set%';和SHOW VARIABLES LIKE 'collation%';,重点关注character_set_server、character_set_database、character_set_client三者是否都为utf8mb4
PHP/Python 连接 MySQL 仍存不了中文
服务端设对了,但应用层没声明编码,请求进来还是按 latin1 解析,等于白配。
实操建议:
- PHP mysqli:创建连接后立刻执行
$mysqli->set_charset("utf8mb4");;PDO 则在 DSN 中加;charset=utf8mb4(如mysql:host=localhost;dbname=test;charset=utf8mb4) - Python PyMySQL:连接时传参
charset='utf8mb4';SQLAlchemy 在 URL 后加?charset=utf8mb4 - Node.js mysql2:在连接配置中加
charset: 'utf8mb4' - 别依赖
SET NAMES utf8—— 它等价于utf8mb3,必须写成SET NAMES utf8mb4
改完之后查询结果乱码或排序异常
字符集升级后,如果校对规则(collation)选得不合适,会导致中文排序错乱(比如「张」排在「李」前面)、大小写敏感异常、或者 WHERE name = '王' 查不到数据。
实操建议:
- 优先用
utf8mb4_unicode_ci(推荐)或utf8mb4_0900_as_cs(MySQL 8.0+,区分大小写且更准),避免用utf8mb4_general_ci(已弃用,排序不准) - 修改已有列 collation 必须用
MODIFY或CHANGE,不能只用ALTER TABLE ... CONVERT TO CHARACTER SET utf8mb4(它会按旧 collation 转换,可能出错) - 如果表里已有乱码数据,单纯改字符集无法恢复——原始字节已被截断或错误解释,只能从备份恢复
最易被忽略的是:改完服务端配置、改完表结构、改完应用连接参数,却忘了改连接时的 SET NAMES 语句或驱动里的 charset 参数。三者缺一不可,漏一个,中文就卡在半路。











