MySQL 8.0 修改默认字符集为 utf8mb4 并生效，必须同时修改配置文件 my.cnf 或 my.ini 的 [mysqld]、[client]、[mysql] 三段配置，重启服务后验证变量，并手动 ALTER 已有数据库和表。

命令速用版

配置文件修改示例（Linux /etc/my.cnf 或 Windows my.ini）：

[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_0900_ai_ci

[client]
default-character-set = utf8mb4

[mysql]
default-character-set = utf8mb4

验证命令：

SHOW VARIABLES LIKE 'character_set%';
SHOW VARIABLES LIKE 'collation%';

为什么会这样

MySQL 字符集生效依赖客户端、服务端、连接会话三层协同，单一配置无法覆盖全链路。

MySQL 8.0 虽然默认字符集可能是 utf8mb4，但许多发行版（如宝塔、Docker 镜像、Windows MSI）仍沿用旧配置，character_set_server 实际仍是 utf8 或 latin1。此外，character_set_client、character_set_connection、character_set_results 必须也都是 utf8mb4，否则客户端发来的 4 字节 Emoji 在解析阶段会被截断。

分步处理

第一步：修改配置文件

编辑 my.cnf 或 my.ini，确保 [mysqld]、[client]、[mysql] 三段均包含 utf8mb4 配置。Windows 用户注意路径含空格需用正斜杠或双反斜杠。

第二步：重启 MySQL 服务

Linux 执行 systemctl restart mysqld，Windows 通过服务管理界面重启。Docker 必须挂载自定义 my.cnf 到 /etc/mysql/my.cnf，权限设为 644。

第三步：转换已有数据库和表

character-set-server 只影响新建库表，对已存在对象无效。需执行：

ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_0900_ai_ci;
ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_0900_ai_ci;

注意字段级定义，若字段硬编码了 CHARACTER SET utf8，需单独 MODIFY COLUMN。

怎么验证是否生效

登录 MySQL 后执行以下命令，重点检查四项关键变量：

SHOW VARIABLES LIKE 'character%';

必须全部满足：character_set_client=utf8mb4、character_set_connection=utf8mb4、character_set_results=utf8mb4、character_set_server=utf8mb4。任一值仍是 utf8 或 latin1，说明配置未加载。

常见坑

• Socket 连接绕过配置：Linux 下用 mysql -u root -p 连接可能走 socket，未读取 [client] 段。强制走 TCP 测试：mysql -h 127.0.0.1 -u root -p。
• init_connect 限制：init_connect='SET NAMES utf8mb4' 对 root 或具有 SUPER 权限的用户不生效。
• 索引长度限制：utf8mb4 下单字符最多占 4 字节，VARCHAR(191) 字段在 utf8mb4 下最大占 764 字节，接近 InnoDB 默认索引长度上限，可能触发 Specified key was too long 错误。
• 配置文件未加载：常见于段落写错（如写到 [mysqld_safe] 下）、路径不对、或被其他同名配置覆盖。

常见问题

插入 Emoji 报 Incorrect string value 错误怎么办？

原因是连接层字符集不一致。检查 character_set_client、character_set_connection、character_set_results 是否全为 utf8mb4，并确保应用连接串显式声明 charset=utf8mb4。

修改配置后已有数据会乱码吗？

仅改配置不会自动转换已有数据编码。必须执行 ALTER TABLE CONVERT TO CHARACTER SET utf8mb4 进行转换，否则旧数据仍按原编码存储。

为什么 SHOW VARIABLES 显示还是 utf8？

说明配置文件未正确加载。检查配置文件路径是否正确，段落是否写在 [mysqld] 下，重启是否成功，或是否被其他配置覆盖。

参考来源

• MySQL 8.0 安装后如何修改默认字符集为 utf8mb4?
• 如何配置 MySQL 8.0 的初始字符集为 utf8mb4_在 my.cnf 添加配置项
• 如何正确配置 MySQL 8.0 的字符集为 utf8mb4 以支持表情存储?
• mysql 如何配置数据库字符集为 utf8mb4_修改 my.cnf 配置文件
• mysql 如何设置字符集为 utf8mb4_修改配置文件与转换编码
• 在 MySQL 中如何将数据库的字符集设置为 utf8mb4? - 数据派 - 博客园
• 如何修改 mysql 默认编码_mysql 编码统一方案
• 怎样解决 MySQL 8.0 迁移后的字符集乱码问题_统一转换为 utf8mb4 编码
• mysql 环境搭建时字符集 utf8mb4 配置方法
• MySQL 字符集 utf8 转换成 utf8mb4 的操作