mysql迁移后乱码主因是client、connection、results、table、column五层字符集未统一为utf8mb4;须逐层验证并同步调整,导出导入也需显式指定utf8mb4。

MySQL 数据库迁移后出现中文或 emoji 乱码,不是数据丢了,而是字符编码在“传输—存储—返回”链路上断开了。核心是确保 client、connection、results、table、column 这五层全部对齐为 utf8mb4,缺一不可。
先确认当前连接实际生效的三件套
乱码第一现场永远在连接层。别急着改配置,连上库直接执行:
SHOW VARIABLES LIKE 'character\_set%';
重点关注以下三项是否全部等于 utf8mb4:
- character_set_client:客户端声明自己发来的是什么编码
- character_set_connection:服务端用什么编码去转换和处理这些数据
- character_set_results:服务端返回结果时按什么编码发回去
常见错误:client=latin1、connection=utf8mb4、results=gbk → 中文经过两次错位转码,必然变 ? 或乱码。临时验证可运行:SET NAMES utf8mb4;,如果立刻恢复正常,问题就卡在这里。
检查并统一库、表、字段级字符集
即使服务端默认设为 utf8mb4,老库老表仍可能沿用 latin1 或 utf8(即 utf8mb3),导致历史数据读取乱码。
逐级检查命令:
- 查库:SELECT DEFAULT_CHARACTER_SET_NAME FROM INFORMATION_SCHEMA.SCHEMATA WHERE SCHEMA_NAME = 'your_db';
- 查表:SHOW CREATE TABLE your_table; 或 SELECT TABLE_COLLATION FROM INFORMATION_SCHEMA.TABLES WHERE TABLE_SCHEMA='your_db';
- 查字段:SELECT COLUMN_NAME, CHARACTER_SET_NAME FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA='your_db' AND DATA_TYPE IN ('varchar','text');
修正顺序必须是:库 → 表 → 字段。例如:
- ALTER DATABASE your_db CHARACTER SET = utf8mb4 COLLATE = utf8mb4_unicode_ci;
- ALTER TABLE your_table CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;(注意:大表会锁表)
- 若只改某字段:ALTER TABLE your_table MODIFY COLUMN content TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
导出与导入环节必须显式指定 utf8mb4
mysqldump 默认按 latin1 读源库,哪怕表里存的是 utf8mb4 字节,也会被错解再错写——导出文件里的中文已经损毁,后续怎么调目标库都没用。
正确导出命令(--default-character-set 必须放在最前面):
mysqldump --default-character-set=utf8mb4 -u root -p mydb > backup.sql
验证导出文件是否可靠:
- file -i backup.sql 应显示 charset=utf-8
- head -n 20 backup.sql | grep CHARSET 应看到 DEFAULT CHARSET=utf8mb4
- 文件开头应有 SET NAMES utf8mb4;
导入时也要保证环境一致:终端 locale 是 UTF-8,mysql 命令行需加 --default-character-set=utf8mb4,否则 SQL 中的中文会被 server 当作 latin1 解码,造成“二次乱码”。
应用与客户端连接参数不能漏
服务端全设对了,但程序没告诉 MySQL “我用的是 utf8mb4”,照样乱。
- JDBC URL 必须含:?useUnicode=true&characterEncoding=utf8mb4
- MySQL Workbench:Connection → Advanced → Others 添加 characterSet=utf8mb4
- 命令行客户端:mysql --default-character-set=utf8mb4 -u root -p
- PHP mysqli:连接后立即执行 mysqli_set_charset($conn, 'utf8mb4');
不复杂但容易忽略。











