如何设置mysql字符集为utf8mb4_mysql字符集配置指南

来源：这里教程网时间：2026-02-28 20:32:31 作者：

MySQL 默认字符集不是 utf8mb4，要支持完整 Unicode（比如 emoji、生僻汉字），必须手动配置为 utf8mb4，并确保 collation 使用 utf8mb4_unicode_ci 或 utf8mb4_0900_ai_ci（MySQL 8.0+ 推荐）。

修改 MySQL 配置文件（my.cnf 或 my.ini）

这是全局生效的关键步骤。找到 MySQL 的配置文件（Linux 通常在 /etc/my.cnf 或 /etc/mysql/my.cnf，Windows 在 MySQL 安装目录下的 my.ini），在对应段落下添加或修改以下内容：

[client] 下添加：
default-character-set = utf8mb4 [mysql] 下添加：
default-character-set = utf8mb4 [mysqld] 下添加：
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci（或 utf8mb4_0900_ai_ci）

⚠️ 注意：不要只写

utf8

—— MySQL 的

utf8

实际是

utf8mb3

，最多只支持 3 字节字符，无法存储 emoji 等 4 字节 Unicode 字符。

重启 MySQL 服务并验证配置

保存配置后，必须重启 MySQL 才能生效：

Linux：
sudo systemctl restart mysql
或
sudo service mysqld restart
Windows：通过服务管理器重启 “MySQL” 服务

SHOW VARIABLES LIKE 'character_set%';<br>SHOW VARIABLES LIKE 'collation%';

重点检查：
character_set_server、collation_server、character_set_database 应全为 utf8mb4 和对应 collation。

对已有数据库、表和字段单独转换

配置文件修改只影响新建库/表。已有对象需显式转换：

修改数据库默认字符集：
ALTER DATABASE db_name CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci; 修改某张表：
ALTER TABLE table_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; 仅修改某个字段（如 TEXT 类型字段）：
ALTER TABLE table_name MODIFY column_name VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

? 提示：执行前建议备份；若字段含索引且长度超限制（如 VARCHAR(255) + utf8mb4 可能超 InnoDB 行限制），可适当减小长度或改用 TEXT。

客户端连接时也需指定 utf8mb4

即使服务端设好了，应用连接时未声明字符集，仍可能乱码。常见做法：

MySQL 命令行连接加参数：
mysql -u user -p --default-character-set=utf8mb4 db_name PHP PDO 连接 DSN 中添加：
charset=utf8mb4（如
mysql:host=localhost;dbname=test;charset=utf8mb4
） Java JDBC URL 添加：
?characterEncoding=utf8mb4&serverTimezone=UTC Python PyMySQL / MySQLdb：在
connect()
参数中指定 charset='utf8mb4'

不设置连接层字符集，即便表是 utf8mb4，插入/查询也可能退化为 latin1 或 utf8mb3 行为。