mysql主从复制遇到编码问题如何解决_解析SET_NAMES的作用

千磊君_1749

千磊君_1749

2026-04-09

208人浏览

原创

主从复制乱码主因是字符集不一致:主库utf8mb4而从库client/connection/results为latin1,导致存储错误编码;需统一配置utf8mb4并验证hex值。

mysql主从复制遇到编码问题如何解决_解析set_names的作用

主从复制中出现乱码,大概率是字符集不一致

MySQL 主从复制本身不校验字符集,只要 SQL 语句能执行就照搬。如果主库用 utf8mb4,从库默认是 latin1 或 utf8(非真正的 UTF-8),写入时看似成功,但实际存储的是错误编码的字节,读出来就是问号或乱码。

常见现象包括:

  • 主库 SELECT 正常显示中文,从库查出来是 ??? 或 Mojibake(如“æ–‡”)
  • 从库 SHOW CREATE TABLE 显示表字符集是 utf8mb4,但 SHOW VARIABLES LIKE 'character_set%' 中 character_set_client、character_set_connection、character_set_results 却是 latin1
  • 主库插入带 emoji 的数据,从库报错 Incorrect string value: '\xF0\x9F\x92\xA9'...

SET NAMES 不是万能的,它只影响当前连接的三个变量

SET NAMES utf8mb4 等价于同时执行:

SET character_set_client = utf8mb4;
SET character_set_connection = utf8mb4;
SET character_set_results = utf8mb4;

但它不会改变:character_set_database、character_set_server、表/列定义的字符集,也不影响已存在的数据编码。所以仅靠应用层执行 SET NAMES,无法修复从库历史乱码,也不能替代服务端配置。

关键点:

MySQL
MySQL

编写正确的MySQL查询,避免字符集、索引和锁方面的常见陷阱。

下载
  • 该命令必须在每次连接建立后、执行业务 SQL 前执行——很多 ORM(如早期 Django、PHP mysqli)会自动做,但自定义连接池或脚本容易漏掉
  • 如果客户端发送的是 latin1 编码字节,却执行 SET NAMES utf8mb4,MySQL 会错误地把这串字节当 utf8mb4 解码,导致双编码(double-encoded)乱码
  • 在 binlog 中,SET NAMES 会被记录为事件(取决于 binlog_format 和 binlog_rows_query_log_events),但从库重放时只影响从库的 SQL 线程连接上下文,不影响已同步的数据

真正要改的是从库的全局 + 会话级字符集配置

修复目标:确保从库接收、解析、存储、返回数据时,各环节字符集链路一致。优先顺序是「服务端配置 > 连接初始化 > 表结构」。

操作步骤:

  • 确认主从都使用 utf8mb4:检查 my.cnf 中是否包含 character-set-server = utf8mb4 和 collation-server = utf8mb4_unicode_ci;重启 MySQL 生效(仅修改变量不持久)
  • 检查从库当前连接的字符集:执行 SHOW VARIABLES LIKE 'character_set%',重点看 character_set_client、character_set_connection、character_set_results 是否全为 utf8mb4
  • 如果从库 SQL 线程连接仍不是 utf8mb4,可在从库启动时加参数 --default-character-set=utf8mb4,或在 CHANGE MASTER TO 语句中显式指定 MASTER_BIND='' 无帮助,真正有效的是让 IO 线程和 SQL 线程都继承 server 配置
  • 已有表需手动转换:对每张表执行 ALTER TABLE tbl_name CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; —— 注意:这会锁表,且不能修复已损坏的双编码数据

如何验证修复是否生效

不能只看 SHOW VARIABLES,要模拟真实写入路径测试:

  • 在主库执行:INSERT INTO t1 (name) VALUES ('测试✅');
  • 等待同步完成,在从库执行:SELECT HEX(name), name FROM t1 WHERE name LIKE '%测试%'; —— 正确应返回 CEB2CAD4E29C95(utf8mb4 编码的十六进制)和可读文字;若返回 C3A6C2B5C2B7,说明是 double-encoded
  • 检查从库 binlog 解析:mysqlbinlog --base64-output=decode-rows -v mysql-bin.000001 | grep -A5 -B5 '测试',确认 event 中的字符串字节与主库原始输入一致
  • 用不同客户端连从库(如 mysql cli、Navicat、Python pymysql),统一设置 charset=utf8mb4 参数,避免客户端自身编码干扰判断

最易被忽略的一点:即使所有配置都对了,如果从库上曾手动执行过 SET NAMES latin1 或类似语句,且该连接还在复用,那么后续 SQL 依然走错路径。排查时一定要看 SHOW PROCESSLIST 并确认 Command 为 Query 的连接的实际变量值。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

mysql

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mysql修改数据表名
mysql修改数据表名

MySQL修改数据表:1、首先查看数据库中所有的表,代码为:‘SHOW TABLES;’;2、修改表名,代码为:‘ALTER TABLE 旧表名 RENAME [TO] 新表名;’。php中文网还提供MySQL的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.20

2093

6

MySQL创建存储过程
MySQL创建存储过程

存储程序可以分为存储过程和函数,MySQL中创建存储过程和函数使用的语句分别为CREATE PROCEDURE和CREATE FUNCTION。使用CALL语句调用存储过程智能用输出变量返回值。函数可以从语句外调用(通过引用函数名),也能返回标量值。存储过程也可以调用其他存储过程。php中文网还提供MySQL创建存储过程的相关下载、相关课程等内容,供大家免费下载使用。

2023.06.21

1279

5

mongodb和mysql的区别
mongodb和mysql的区别

mongodb和mysql的区别:1、数据模型;2、查询语言;3、扩展性和性能;4、可靠性。本专题为大家提供mongodb和mysql的区别的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.18

755

5

mysql密码忘了怎么查看
mysql密码忘了怎么查看

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql密码忘了怎么办呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.19

2792

5

mysql创建数据库
mysql创建数据库

MySQL是一个关系型数据库管理系统,由瑞典MySQL AB 公司开发,属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一,在 WEB 应用方面,MySQL是最好的 RDBMS 应用软件之一。那么mysql怎么创建数据库呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.25

4648

4

mysql默认事务隔离级别
mysql默认事务隔离级别

MySQL是一种广泛使用的关系型数据库管理系统,它支持事务处理。事务是一组数据库操作,它们作为一个逻辑单元被一起执行。为了保证事务的一致性和隔离性,MySQL提供了不同的事务隔离级别。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

2023.08.08

1079

3

sqlserver和mysql区别
sqlserver和mysql区别

SQL Server和MySQL是两种广泛使用的关系型数据库管理系统。它们具有相似的功能和用途,但在某些方面存在一些显著的区别。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.11

4911

4

mysql忘记密码
mysql忘记密码

MySQL是一种关系型数据库管理系统,关系数据库将数据保存在不同的表中,而不是将所有数据放在一个大仓库内,这样就增加了速度并提高了灵活性。那么忘记mysql密码我们该怎么解决呢?php中文网给大家带来了相关的教程以及其他关于mysql的文章,欢迎大家前来学习阅读。

2023.08.14

4382

7

mysql事务隔离级别
mysql事务隔离级别

mysql规范中定义了四种事务隔离级别,不同的隔离级别对事务的处理有所不同。本专题为大家提供mysql事务隔离级别相关的文章内容,大家可以免费体验。

2023.08.16

5734

11

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 178人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 285人学习