MySQL字符集乱码,数据库、表
MySQL字符集乱码通常不是单一原因,而是数据库、数据表和连接层三层字符集设置不一致导致的。
本文以 utf8mb4 为标准,带你从头到尾检查库、表、连接配置,解决中文和 emoji 乱码,适合刚接触 MySQL 的新手直接照做。
为什么推荐 utf8mb4
utf8mb4 是 MySQL 推荐使用的完整 UTF-8 编码,支持中文、日文、韩文以及 emoji 表情。
而老的 utf8 在 MySQL 里最多只能存 3 字节,遇到 emoji 就会变成问号或乱码。
三层统一使用 utf8mb4,才能保证写入和读取一致。
第一步:查看当前字符集
登录 MySQL 后执行:
SHOW VARIABLES LIKE 'character_set%';
重点看 character_set_database、character_set_server、character_set_connection 和 character_set_client。
如果结果里有 latin1 或 utf8mb3,就说明需要调整。
第二步:把数据库和数据表改为 utf8mb4
先修改数据库默认字符集:
ALTER DATABASE 你的库名 CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
再修改数据表,如果表很多,先查出来批量拼 SQL:
SELECT CONCAT('ALTER TABLE `', table_name, '` CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;')
FROM information_schema.TABLES
WHERE table_schema = '你的库名';
把生成的语句复制执行即可。CONVERT TO 会连同表内字段一起转换,比单独改字段更省事。
第三步:调整连接层字符集
连接层是指程序连接 MySQL 时使用的客户端字符集。
如果这里不设置,即使库和表都是 utf8mb4,仍可能出现乱码。
通过命令行连接时,先执行:
SET NAMES utf8mb4;
Java JDBC 连接串里加参数:
jdbc:mysql://localhost:3306/你的库?characterEncoding=utf8mb4&useUnicode=true
PHP PDO 设置:
$pdo = new PDO($dsn, $user, $pass, array(PDO::MYSQL_ATTR_INIT_COMMAND => "SET NAMES utf8mb4"));
MySQL 配置文件 my.cnf 的 [client] 和 [mysqld] 段也建议加上:
[client]
default-character-set = utf8mb4
[mysqld]
character-set-server = utf8mb4
collation-server = utf8mb4_unicode_ci
改完重启 MySQL 服务生效。
避开三个常见坑
第一,只改库不改连接层,页面输出仍可能乱码;
只改连接层不改表,旧数据乱码依然存在。
三层必须同步检查。
第二,已有数据中如果已经混入乱码字符,转换不能自动恢复,需要先从源头修正后再转换。
第三,utf8mb4_unicode_ci 和 utf8mb4_general_ci 都能用,前者排序更规范,后者速度略快。
如果字段做了主键或唯一索引,转换前先确认索引长度,旧版本 MySQL 可能会超限。
最后验证写入和读取
新建一张测试表,插入一行含中英文和 emoji 的数据:
CREATE TABLE test_utf8mb4 (content VARCHAR(100)) CHARSET=utf8mb4;
INSERT INTO test_utf8mb4 VALUES ('你好,世界 🌍');
SELECT content FROM test_utf8mb4;
如果查询结果能正常显示蓝色圆球表情,说明字符集已生效。
再用程序读一遍,确认页面显示正常就算完成。
如果你正在处理 MySQL 数据库、表、连接层 utf8mb4 全套配置,建议按上面顺序整体过一遍,不要只改其中一层。
遇到乱码时,优先用 SHOW VARIABLES LIKE 'character_set%' 定位不一致项,再按本文步骤修改即可。