CLONE LOCAL 仅在源实例正常运行时创建物理副本,不用于崩溃恢复;要求源实例ONLINE、目标路径不存在、插件永久加载且克隆后需处理server_uuid等启动问题。

CLONE LOCAL 不能用于“从损坏中恢复”,只能在源实例正常运行的前提下快速生成一份物理副本;它不跳过崩溃恢复流程,也不修复坏页或日志断裂。
CLONE LOCAL 前必须确认源实例能正常启动
克隆操作要求 donor 实例处于 ONLINE 状态,且能执行完整事务处理。如果实例因 innodb_force_recovery > 0 启动、或报 Tablespace is missing、Corrupted page 等错误,CLONE LOCAL DATA DIRECTORY 会直接失败,报 ERROR 3864 或静默卡住。
- 先用
mysqld --innodb-force-recovery=1启动 —— 这只是临时绕过部分崩溃检查,不代表数据可克隆 - 真正能克隆的前提是:执行
SELECT 1;、SHOW TABLES;、FLUSH TABLES WITH READ LOCK;全部成功 - 若源库已 crash shutdown 且无法干净启动,应优先用
xtrabackup --prepare恢复,再考虑克隆
目标路径权限和存在性是本地克隆失败最常见原因
CLONE LOCAL 不是“复制到目录”,而是“重建整个 datadir 结构”。哪怕目标路径下只有 .keep 或空子目录,也会报 ERROR 3862(Invalid argument)。
面向 CRM 系统的 MySQL 8 数据库模式设计。当用户需要为客户关系管理(CRM)系统设计、评审、优化或生成数据库模式时,应使用此项技能。
- 目标路径必须完全不存在:
/data/clone_20261104✅,/data/clone_20261104/(末尾斜杠不影响)✅,/data/clone_20261104/.❌ - 创建后立即执行:
chown -R mysql:mysql /data/clone_20261104—— 只改父目录属主不够,子项必须递归归属 - 磁盘剩余空间必须 ≥
du -sh /var/lib/mysql | cut -f1输出值,CLONE 不压缩、不 dedupe
插件未永久加载会导致命令根本不可用
执行 CLONE LOCAL DATA DIRECTORY = '/path'; 报 Unknown command 'CLONE' 或 ERROR 1126 (HY000): Can't open shared library 'mysql_clone.so',90% 是插件没加载,不是权限问题。
- 动态安装
INSTALL PLUGIN clone SONAME 'mysql_clone.so';仅当前会话有效,重启即失效 - 必须在
/etc/my.cnf的[mysqld]段追加两行:plugin-load-add = mysql_clone.so和clone = FORCE_PLUS_PERMANENT - 改完配置必须
systemctl restart mysqld,reload不重载插件 - 登录后第一件事:
SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'clone';,结果必须为ACTIVE
克隆完成后不能直接启动新实例
克隆出的目录可作为新实例的 datadir,但直接 mysqld --datadir=/data/clone_20261104 启动会失败,常见两个硬性阻碍:
-
auto.cnf中的server_uuid与原实例重复 → 启动报错Server ID collision→ 必须删掉该文件,让 MySQL 重启时自动生成 - 若原实例启用了
innodb_file_per_table = OFF,而目标实例配置为ON,启动时可能报Tablespace not found→ 建议克隆前后保持innodb_file_per_table一致 - 克隆不保证 binlog 位点连续,若要配主从,需在克隆前记录
SHOW MASTER STATUS,克隆后手动CHANGE REPLICATION SOURCE TO ...
真正容易被忽略的是:CLONE LOCAL 的“加速”只体现在 GB 级数据(2–5 GB)上,TB 级别仍需数分钟,且全程阻塞 DDL —— 如果你正等着加个索引,克隆期间它会一直排队,直到克隆结束才执行。

















