必须先升从库并确认Seconds_Behind_Master=0、GTID集合一致、read_only与super_read_only均为ON,再切主库;否则停主库会导致未同步binlog静默丢失。

Seconds_Behind_Master > 0 时停主库 = 数据静默丢失
主库一停,所有未同步到从库的 binlog 就永远断在半路。只要 Seconds_Behind_Master 不是 0,就说明从库还没追上——这部分变更不会自动补传,也不会写进新主库的 binlog。应用层感知不到,但数据已实质不一致。
常见错误现象:Lost connection to MySQL server 频发(连接池长连接未重连)、ERROR 1062: Duplicate entry 突然爆发(super_read_only=OFF 的从库被误写,切主后主键冲突)。
- 必须先确认每台从库
Seconds_Behind_Master = 0,且Slave_SQL_Running_State显示Slave has read all relay log - 用
SELECT GTID_SUBSET(@@global.gtid_executed, 'xxx')=1校验Retrieved_Gtid_Set和Executed_Gtid_Set完全一致 -
read_only=ON和super_read_only=ON必须双开,防止误写
老版本 datadir 被新版本 mysqld 直接启动会卡死或损坏元数据
跨大版本(如 5.7 → 8.0)时,系统表结构、数据字典存储方式已变。新版本 mysqld 强行读取旧 datadir,大概率卡在初始化阶段,或静默损坏 mysql.ibd、innodb_index_stats 等关键表。
正确做法是:停从库前执行 STOP SLAVE SQL_THREAD(保留 IO 线程,避免丢 position),再关 mysqld;替换 basedir(bin/docs/lib 等目录),但 datadir 原样保留;启动后立刻 START SLAVE,靠 SQL 线程重放中继日志完成兼容性过渡。
- 小版本升级(如 8.0.33 → 8.0.39)可复用原
datadir;大版本必须跑mysqld --upgrade或按官方流程重建系统表 - 配置文件里废弃参数如
innodb_locks_unsafe_for_binlog必须删除,否则启动失败 -
default_authentication_plugin=caching_sha2_password若客户端不支持,需临时设为mysql_native_password
只验证 SELECT 1 和 mysqld --version 就切流,第二天必出问题
服务“能连上”不等于业务逻辑正常。MySQL 8.0 默认 trx_isolation=READ-COMMITTED、默认排序规则变成 utf8mb4_0900_ai_ci、隐式类型转换行为收紧——这些都不会报错,但会导致慢查询暴增、分页错乱、去重失效。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
必须用真实业务账号和语句验证:
-
INSERT INTO t VALUES (1, '中文')确认排序/搜索逻辑没崩 -
SELECT * FROM information_schema.INNODB_TRX查trx_isolation是否符合预期 -
EXPLAIN FORMAT=tree SELECT * FROM t WHERE id = ?比对是否出现Using temporary; Using filesort(典型索引失效信号)
多源复制或级联复制下,通道独立性让升级顺序更敏感
每个复制通道(Channel)有自己的一套 relay log、IO 线程、SQL 线程。升级从库时若没逐个 STOP SLAVE FOR CHANNEL 'xxx',部分通道可能还在拉旧主库的 binlog,而新版本 mysqld 已不兼容该协议格式,导致 IO 线程直接报错退出。
尤其当主库之间也存在复制关系(如级联架构),必须按拓扑顺序升:最下游从库 → 中间节点 → 最上游主库。否则中间节点升级后无法向新主库注册,整个链路中断。
- 升级前用
SHOW SLAVE STATUS FOR CHANNEL 'xxx'\G逐个检查状态 - 升级后用
START SLAVE FOR CHANNEL 'xxx'逐个启动,不能START SLAVE全局启动 - 监控必须细化到 channel 级别,
Seconds_Behind_Master是全局值,掩盖单通道延迟
真正容易被忽略的是 GTID 集合校验和字符集行为回归测试——它们不报错,但会让数据在某次凌晨批量任务后悄悄错位。升级不是“服务起来就完事”,而是“所有业务路径都走通一遍”。

















