必须让character_set_client、character_set_connection、character_set_results三者同时为utf8mb4,否则select也会触发incorrect string value错误;因为mysql返回结果前按character_set_results转换字段值,若其为utf8而实际存储是utf8mb4的4字节序列(如emoji),解析失败即报错。

必须让 character_set_client、character_set_connection、character_set_results 三者同时为 utf8mb4,否则哪怕只是 SELECT 也会报 Incorrect string value 错误。
为什么 SELECT 都会触发 Incorrect string value?
很多人以为这错误只在 INSERT 时出现,其实不是。MySQL 在返回结果前,会按 character_set_results 把字段值转成对应编码再发给客户端。如果该值实际是 utf8mb4(比如存了 emoji 或扩展汉字),但 character_set_results 是 utf8(即 utf8mb3),MySQL 就会尝试用 3 字节规则解析 4 字节序列,直接判定非法并报错。
典型现象:SELECT * FROM user WHERE id = 1; 报错 Incorrect string value: '\xF0\x9F\x98\x80' for column 'name' at row 1 —— 你没改数据,只是读,照样崩。
-
character_set_client:告诉 MySQL “我发的 SQL 里字符串是什么编码” -
character_set_connection:MySQL 内部转换用的中间编码,必须和 client 一致才能无损传递 -
character_set_results:决定返回结果(列名、字段值、警告)用什么编码发给你
如何确认当前连接的三字符集是否一致?
连上 MySQL 后执行:
SHOW VARIABLES LIKE 'character\_set\_client';<br>SHOW VARIABLES LIKE 'character\_set\_connection';<br>SHOW VARIABLES LIKE 'character\_set\_results';
三者输出值都必须是 utf8mb4。只要有一个是 utf8 或 latin1,就存在风险。
常见陷阱:
-
mysql命令行客户端默认不带--default-character-set=utf8mb4,character_set_client仍是utf8 - DMS、Navicat 等 GUI 工具需手动在连接配置里勾选“UTF8MB4”或填入
charset=utf8mb4,不能依赖“自动检测” - 旧版 JDBC 驱动(如
mysql-connector-java 5.x)即使 URL 里写了characterEncoding=utf8mb4,仍可能忽略,必须搭配useUnicode=true
表结构和服务器配置不等于连接层安全
即使你已执行过:
ALTER DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ciALTER TABLE t CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci-
my.cnf里配了character-set-server=utf8mb4
——这些只保证存储层支持 utf8mb4,但每次新连接仍可能回落到 utf8。MySQL 不会自动继承服务端配置,必须显式声明。
不同客户端强制设置方式:
- 命令行:
mysql --default-character-set=utf8mb4 -u root -p - JDBC URL:
jdbc:mysql://localhost:3306/db?characterEncoding=utf8mb4&useUnicode=true - PHP PDO:
new PDO($dsn, $user, $pass, [PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"]) - Python PyMySQL:
charset='utf8mb4'参数传入connect()
容易被忽略的 init_connect 和 handshake 问题
有人加了 init_connect='SET NAMES utf8mb4' 还出错,是因为 MySQL 默认允许客户端协商字符集(character-set-client-handshake=TRUE),会覆盖 init_connect 的设置。
真正可靠的写法是:
[mysqld]<br>character-set-server=utf8mb4<br>collation-server=utf8mb4_unicode_ci<br>init_connect='SET NAMES utf8mb4'<br>character-set-client-handshake=FALSE
注意:character-set-client-handshake=FALSE 必须加,否则客户端发起连接时仍可自行指定 utf8,导致三字符集不一致。
改完记得重启 MySQL 服务,且所有已有连接需重连才生效。











