跨版本主从复制仅支持5.7主→8.0从,须严格对齐gtid_mode、enforce_gtid_consistency、binlog_row_metadata等参数,禁用writeset与caching_sha2_password兼容性风险,并统一binlog_checksum为crc32。

只允许 5.7 主 → 8.0 从,反向绝对不可行;所谓“跨版本”不是指任意混搭,而是单向向下兼容的有限组合。
检查主从 gtid_mode 和 enforce_gtid_consistency 是否对齐
这是最常被忽略却最致命的兼容性断点。8.0 默认强制开启 gtid_mode=ON 和 enforce_gtid_consistency=ON,而 5.7 主库若未显式启用 GTID(尤其老版本或未升级到 5.7.29+),从库在初始化时就会卡在 Retrieved_Gtid_Set 为空、Executed_Gtid_Set 却有值的状态,后续任何 START REPLICA 都会拒绝执行。
- 必须在主库和从库上分别执行:
SELECT @@gtid_mode, @@enforce_gtid_consistency, @@binlog_format, @@server_id; - 若主库
gtid_mode=OFF,从库也必须设为OFF(不能依赖 AUTO_POSITION) - 若主库已开 GTID,需确认其
gtid_purged未被清理——用SHOW MASTER STATUS对比Executed_Gtid_Set和 binlog 文件范围 - 不一致时,优先关掉主库 GTID:
SET GLOBAL gtid_mode = OFF_PERMISSIVE;→SET GLOBAL gtid_mode = OFF;(需先SET GLOBAL enforce_gtid_consistency = OFF;)
验证 binlog_row_image 和 binlog_row_metadata 是否兼容
8.0 默认启用 binlog_row_metadata=FULL,它会在 row event 中嵌入表元数据哈希,5.7 从库完全不认识这个字段,解析直接报 Unknown binlog event type 或卡死在 IO_THREAD。
- 主库(5.7)无需调整,但必须确保
binlog_format=ROW且binlog_row_image=FULL(避免部分更新导致列偏移) - 从库(8.0)要禁用新特性干扰:在配置中显式写
binlog_row_metadata=NONE,否则即使主库是 5.7,8.0 从库自己生成的中继日志也可能带不兼容字段 - 检查命令:
SELECT @@binlog_row_image, @@binlog_row_metadata;,两者都应为FULL(主库)和NONE(从库) - 注意:8.0.33+ 引入了
binlog_transaction_compression,若主库没开压缩而从库开了,也会导致 event 解析失败
确认驱动与客户端协议是否支持 8.0 认证插件
MySQL 8.0 默认使用 caching_sha2_password 插件,而旧版 JDBC(mysqli 扩展无法原生处理该握手流程,表现为连接主库成功、但从库启动复制时报 Access denied for user 或卡在 AUTHENTICATION_PLUGIN
- 主库创建复制用户时,显式指定旧插件:
CREATE USER 'repl'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx'; - 避免用
ALTER USER ... IDENTIFIED BY,它默认沿用当前插件,可能悄悄切到caching_sha2_password - JDBC 连接串必须加参数:
?serverTimezone=UTC&allowPublicKeyRetrieval=true&useSSL=false(仅测试环境),生产环境建议升级驱动至 8.0.28+ - Python 用户应弃用
MySQLdb,改用pymysql(>=1.1.0)或mysql-connector-python(>=8.0.33)
小版本间也要核对 binlog_checksum 和并行复制类型
5.7.29+ 默认开启 binlog_checksum=CRC32,低于此版本默认是 NONE。若主库开了校验而从库没配对应值,会报 Master requested checksum validation but slave doesn't support it;此外,slave_parallel_type=WRITESET 是 5.7.22 后才支持的,老从库遇到 WRITESET 事件直接崩溃。
- 统一设为
binlog_checksum=CRC32,并在 my.cnf 中静态配置,重启生效(仅SET GLOBAL不够) - 跨小版本部署时,从库配置强制设
slave_parallel_type=DATABASE或LOGICAL_CLOCK,禁用WRITESET - 检查命令:
SELECT @@binlog_checksum, @@slave_parallel_type; - 注意:8.0 默认启用
transaction_write_set_extraction=XXHASH64,若主库是 8.0,哪怕从库是 5.7.40 也无法识别——所以再次强调,8.0 主 → 5.7 从是硬性禁止
真正容易被跳过的点是:你以为只要版本号看着“能向下兼容”,就忽略了运行时参数的隐式行为差异。比如 sql_mode 默认值变更、collation_server 字符集迁移、甚至 max_allowed_packet 在大事务场景下的截断表现——这些不会让复制立刻失败,但会导致某条 UPDATE 应用后字段值被静默截断,数月后才发现数据不一致。











