MySQL 5.7 utf8mb4表无法存储emoji报错原因咨询

别着急，这个问题我之前排查过好几次——虽然你给表指定了utf8mb4编码，但MySQL处理字符集是个端到端的流程，有几个容易遗漏的环节没配置对，才会导致插入Emoji失败。

1. 连接层的字符集没跟上 #

这是最常见的原因：你的表和列用了utf8mb4，但客户端与服务器的连接字符集还是默认的utf8（注意MySQL的utf8只支持3字节字符，Emoji是4字节的）。

• 临时修复：在执行插入语句前先运行这条命令：

  SET NAMES utf8mb4;
  

  再执行你的INSERT语句，应该就能成功了。

• 永久解决：修改MySQL的配置文件（Linux是/etc/my.cnf或/etc/mysql/my.cnf，Windows是my.ini），添加以下配置：

  [client]
  default-character-set=utf8mb4
  
  [mysql]
  default-character-set=utf8mb4
  
  [mysqld]
  character-set-client-handshake = FALSE  # 强制使用配置的字符集，忽略客户端请求
  character-set-server=utf8mb4
  collation-server=utf8mb4_unicode_ci
  

  保存后重启MySQL服务，这样所有新连接都会默认用utf8mb4。

2. 数据库级别的字符集不是utf8mb4 #

如果你的数据库本身还是utf8编码，即使表单独设置了utf8mb4，也可能出现继承性的字符集冲突。

先检查数据库的字符集：

SHOW CREATE DATABASE your_db_name;

如果结果里CHARACTER SET不是utf8mb4，执行这条命令修改：

ALTER DATABASE your_db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

3. 确认列的字符集配置正确 #

虽然你建表时写了utf8mb4_bin，但还是建议再核对一下列的实际配置，避免拼写或语法错误：

SHOW CREATE TABLE emails;

查看subject列的字符集是否确实是utf8mb4_bin，如果不是，执行修改：

ALTER TABLE emails MODIFY COLUMN subject varchar(191) COLLATE utf8mb4_bin DEFAULT NULL;

4. 确保MySQL版本支持utf8mb4 #

MySQL 5.5.3及以上才正式支持utf8mb4，不过你用的是5.7，这一步应该没问题，但还是可以确认下版本：

SELECT VERSION();

最后再试一次 #

配置完以上内容后，重新连接MySQL，执行你的插入语句：

INSERT INTO `emails` (`subject`) VALUES ('A😀B C👨🏽‍🎨D');

这次应该就能成功插入包含Emoji的记录了。

简单来说，utf8mb4需要从数据库、表、列，到客户端连接全链路统一配置，任何一个环节没跟上都会导致4字节的Emoji插入失败。

内容的提问来源于stack exchange，提问作者Arnold Roa