编程 MySQL 9.7 的 Clone 能跨 LTS 了,但只放开一代:9.7→10.7 可以,9.7→11.7 不行

2026-11-18 21:02:24

MySQL 9.7 的 Clone 能跨 LTS 了,但只放开一代:9.7→10.7 可以,9.7→11.7 不行

WL#16520 的任务名叫 “InnoDB: Allow clone from one LTS version to the next”,状态 Complete,落在 Server-9.x:

  • Worklog:
  • 9.7.0 Release Notes:

它的目标很克制:放宽 Clone 的版本限制,但只允许 in-place upgrade 支持、而 in-place downgrade 不支持的那些组合。换句话说,能升级上去的路径,才允许物理搬过去。

规则矩阵:只放开“同代”和“相邻下一代 LTS”

Clone 之前要求源端和副本是同一个 server version。WL#16520 之后:

源 → 副本是否允许
9.7.x → 9.7.y(同一 LTS 内)允许
9.7.x → 10.7.y(紧邻的下一个 LTS)允许
9.7.x → 11.7.y(跨过一代 LTS)不允许
10.7.x → 9.7.y(高版本源到低版本副本)不允许
9.7.x → 8.4.y 或 9.z(z<7)不允许
8.x.y 或 9.z(z<7)→ 9.7.x不允许
9.7.x → 10.0.y、10.4.x → 10.7.y 这类非 LTS 且 major/minor 不一致不允许

几条边界要单独记:

  • 只对 9.7 及以上版本生效,8.4 不在这个规则里。
  • 跨代必须是紧邻的:replica.major == source.major + 1,不是“任意更高的 LTS”。
  • 降级一律禁止:高版本源不能喂给低版本副本。
  • FR-4 单独兜底:只要源或副本有一方不是 LTS(即 Innovation Release),并且 major 和/或 minor 不一致,就不允许克隆。所以 9.7.x → 10.0.y、10.4.x → 10.7.y 都会被挡下。

背景:clone 靠的是“配置对配置”的校验

克隆时,源端会把一组预定的配置发给副本,副本拿这些值和自己的配置比对,再决定这次克隆是否放行。这些值通过 sysvar service 读取系统变量,其中 version 系统变量用来判定 server 版本。

问题在于:光有版本号不够。要判断“是不是紧邻的 LTS”,clone 必须知道某个版本是 Long Term Stability(LTS)还是 Innovation Release(IR)。这个信息来自构建期生成的 MYSQL_VERSION_MATURITY 宏,因此它也必须从源端传到副本端。

而 clone 以前是把每条配置独立校验的:版本校验只看 version,彼此不关联。现在 version 和 maturity 必须放在一起看,才能得出“这是不是同代/相邻代”的结论。

实现:把 version 和 maturity 打包成一个 JSON

源端新增一条配置 maturity,取值就是 MYSQL_VERSION_MATURITY,即 "LTS" 或 "INNOVATION"。为了能让 version 和 maturity 并行处理,两者被打包进同一个 JSON 字符串:

  1. 源端构造一个 JSON 文档,里面是 name/value 对,分别对应 version 和 maturity,序列化后发给副本;
  2. 副本构造自己的 JSON 文档,反序列化源端那份,用 sysvar reader service 和 MYSQL_VERSION_MATURITY 填充自己的值,然后执行兼容性检查。

协议层面,clone protocol 升到 CLONE_PROTOCOL_VERSION_V4,新增 COM_RES_CONFIG_V4 命令来承载这个 JSON。低版本协议仍然走旧机制,向后兼容保留。

兼容性判断:are_versions_clone_compatible()

检查函数按下面的顺序短路返回:

are_versions_clone_compatible(replica, source):
if replica == source: return true
if replica.major == source.major and replica.minor == source.minor: return true

if replica.major != source.major:
if replica < source: return false          # 不支持降级
if replica < 9.7.0 or source < 9.7.0: return false
if replica.maturity != LTS or source.maturity != LTS: return false
if replica.major != source.major + 1: return false
return true

# major 相同、minor 不同
return false                                   # 对 Innovation 不做支持

拆开看就是四道闸:版本完全相同 → 放行;major/minor 都相同 → 放行;major 不同时,先排除降级,再排除 9.7 以下的版本,再排除任一方非 LTS,最后要求 major 恰好差 1;major 相同但 minor 不同,直接拒绝,不对 Innovation 版本做兼容。

为什么能放宽:物理格式对上一个 LTS 向后兼容

Clone 做的是运行中实例的动态物理快照,副本侧用常规 recovery 从快照恢复,所以它天然依赖数据和日志的物理格式。历史上要求两端 server version 完全一致,就是为了保证物理格式对得上。

放宽的依据是:物理格式的变更对上一个 LTS 保持向后兼容。既然从 9.7 的数据文件能走到 10.7,那么 9.7 的快照在 10.7 上恢复也就成立。但再往前一代(11.7)就没有这层保证,于是被规则矩阵挡掉。

实操建议

  • 克隆只用于同代或升一代的物理搬机:9.7.x → 9.7.y 做小版本漂移,或者 9.7.x → 10.7.y 做 LTS 升级时的快速建库,这两类放心用。
  • 降版本不要试:10.7.x → 9.7.y 会直接被拒绝,逻辑上也没有物理格式的兼容承诺。
  • 跨两代不行:9.7.x → 11.7.y 不满足 major + 1,必须先升到 10.7 再往上走,或者干脆不用 clone。
  • 这些情况走 dump + upgrade:降版本、跨两代、以及源或副本是 Innovation Release 且 major/minor 不一致的组合,都老老实实逻辑导出再按升级路径走。
  • 9.7 以下的实例(比如 8.4.x)不在这套规则覆盖范围内,与 9.7 之间双向都不允许克隆。

9.7.0 的 release note 对此的表述是:Clone 插件现在支持在高于 9.7.0 的连续 LTS 版本之间克隆,细节参见 Clone Plugin Limitations 与 Remote Cloning Prerequisites。

复制全文 生成海报 MySQL 复制 升级

推荐文章

程序员茄子在线接单