mysql主从复制场景下,主从实例字符集配置不一致会直接导致同步中断,常见的报错包括Incorrect string value、Illegal mix of collations等,这类问题本质是数据在从库回放时,字符编码转换规则不匹配导致的。解决这类问题需要先定位字符集差异点,再逐步统一配置。

主从字符集不一致的常见报错场景
主从字符集不一致引发的报错通常出现在以下场景:
- 主库使用utf8mb4字符集写入emoji等特殊字符,从库表字符集为utf8,无法存储对应字符
- 主从实例的默认字符集不同,比如主库是utf8mb4,从库是latin1,创建新表时自动继承从库默认字符集,导致同步时字段类型不匹配
- 主从表的排序规则(collation)不一致,执行字符串比较、关联查询相关的SQL时触发编码冲突
排查主从字符集差异的步骤
1. 查看实例级字符集配置
分别登录主库和从库,执行以下命令查看实例的默认字符集和排序规则:
-- 查看主库字符集配置 SHOW VARIABLES LIKE 'character_set%'; SHOW VARIABLES LIKE 'collation%'; -- 查看从库字符集配置,执行相同命令 SHOW VARIABLES LIKE 'character_set%'; SHOW VARIABLES LIKE 'collation%';
重点关注character_set_server、collation_server两个参数,这两个参数决定了新建库表的默认字符集。
2. 查看库级字符集
检查主从对应数据库的字符集是否一致:
-- 查看所有数据库的字符集配置
SELECT SCHEMA_NAME,DEFAULT_CHARACTER_SET_NAME,DEFAULT_COLLATION_NAME
FROM information_schema.SCHEMATA
WHERE SCHEMA_NAME NOT IN ('information_schema','mysql','performance_schema','sys');
3. 查看表级和字段级字符集
针对同步报错的表,分别查询主从表的字符集和字段字符集:
-- 查看表的字符集 SHOW TABLE STATUS FROM 数据库名 LIKE '表名'; -- 查看表所有字段的字符集 SHOW FULL COLUMNS FROM 数据库名.表名;
解决主从字符集不一致的操作方案
1. 临时修复同步报错
如果当前主从同步已经中断,先跳过当前报错的事务,恢复同步(仅临时使用,后续需要统一字符集):
-- 停止从库同步 STOP SLAVE; -- 跳过1个报错事务,如果是GTID模式可以设置GTID_NEXT跳过对应事务 SET GLOBAL sql_slave_skip_counter = 1; -- 重新启动同步 START SLAVE;
2. 统一实例级字符集配置
修改主从实例的配置文件my.cnf(或my.ini),添加以下配置,然后重启mysql实例:
[mysqld] character_set_server=utf8mb4 collation_server=utf8mb4_general_ci init_connect='SET NAMES utf8mb4'
重启后再次执行SHOW VARIABLES LIKE 'character_set%'确认配置生效。
3. 统一库表字符集
对于已经存在的字符集不一致的库和表,执行修改语句统一配置,注意修改前先备份数据:
-- 修改数据库字符集,会修改后续新建表的默认字符集,不会修改已有表 ALTER DATABASE 数据库名 CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; -- 修改表的字符集,同时转换所有字符字段的字符集 ALTER TABLE 数据库名.表名 CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
如果只需要修改单个字段的字符集,可以使用以下语句:
ALTER TABLE 数据库名.表名 MODIFY COLUMN 字段名 VARCHAR(255) CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci NOT NULL;
统一字符集后的验证
完成所有配置修改后,需要验证主从同步是否正常,字符集是否统一:
- 执行
SHOW SLAVE STATUSG查看从库同步状态,确认Slave_IO_Running和Slave_SQL_Running都为YES,无报错信息 - 主库写入包含特殊字符的测试数据,检查从库是否能正常同步,无乱码
- 再次执行库表字符集查询语句,确认主从对应库表的字符集、排序规则完全一致
注意:修改已有表的字符集时,如果表数据量较大,执行CONVERT TO CHARACTER SET操作会锁表,建议在业务低峰期执行,避免影响线上业务。