如何在MySQL中正确设置utf8mb4字符集以支持表情符号？-mysql教程-PHP中文网

mysql 8.0默认字符集改为utf8mb4，因其是完整utf-8实现（支持4字节unicode字符），而旧utf8实为utf8mb3、仅支持3字节，无法存储emoji及生僻汉字，否则报incorrect string value。

如何在mysql中正确设置utf8mb4字符集以支持表情符号？

MySQL 5.5.3+ 必须用 `utf8mb4`，`utf8` 不行

MySQL 的 utf8 实际是阉割版，最多只支持 3 字节字符（U+0000–U+FFFF），而 emoji 大量使用 4 字节 Unicode 码位（如 ? U+1F308、? U+1F44D）。直接设 utf8 会导致插入失败或被静默截断。从 5.5.3 起官方提供完整 UTF-8 实现 utf8mb4，必须显式启用。

服务端、数据库、表、列四层都要设 `utf8mb4`

只改其中一层没用——比如只改表字符集，但连接用的是 latin1，照样乱码。关键点：

MySQL（Linux）

MySQL 9.6.0是面向Linux平台的2026年创新版本，核心架构迎来重大革新。其将外键约束与级联操作从InnoDB引擎层上移至SQL层，确保所有数据变更均被完整记录至Binlog，彻底解决了CDC（变更数据捕获）与主从复制中的数据不一致难题。此外，该版本引入container_aware启动选项以原生适配容器环境，并对审计日志进行了组件化重构，为追求极致数据一致性与云原生体验的开发者提供了全新选择。

下载

在 my.cnf（Linux）或 my.ini（Windows）的 [mysqld] 段下加：

[mysqld]<br>character-set-server = utf8mb4<br>collation-server = utf8mb4_unicode_ci

重启 MySQL 后确认生效：SHOW VARIABLES LIKE 'character_set_server'; 和 SHOW VARIABLES LIKE 'collation_server';
新建数据库时指定：CREATE DATABASE db_name CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
已有表需逐个转换：ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
特别注意：如果列类型是 TEXT 或 VARCHAR，且原长度接近上限（如 VARCHAR(255)），转 utf8mb4 后实际存储字节数翻倍（最大 4 字节/字符），可能触发 row size too large 错误。此时要先缩小字段长度，或改用 TEXT 类型

客户端连接必须声明 `utf8mb4`，不能依赖默认

即使服务端全设对了，应用连接时没声明字符集，MySQL 仍按 character_set_client 解析请求，导致写入乱码或报错 Incorrect string value。不同场景处理方式：

命令行客户端：启动时加 --default-character-set=utf8mb4，或连接后执行 SET NAMES utf8mb4;
PHP PDO：DSN 中加 ;charset=utf8mb4，例如 mysql:host=localhost;dbname=test;charset=utf8mb4；不要只靠 set_charset('utf8mb4')，它不保证初始化阶段正确
Java JDBC：URL 加参数 ?characterEncoding=utf8mb4&serverTimezone=UTC（注意是 utf8mb4，不是 utf8）
Node.js mysql2：配置项 charset: 'utf8mb4'，不是 'UTF8' 或 'utf8'