克隆插件在 MySQL 8.0.21+ 默认禁用,需手动安装;远程克隆要求版本完全一致、目标数据目录为空、源端授权 BACKUP_ADMIN 用户、目标端配置 clone_valid_donor_list;CLONE INSTANCE 卡住常见于网络/IO/参数问题,可调并发线程或禁用 SSL 加密;克隆后需手动配置主从或 MGR 复制关系,并单独处理用户密码。

克隆插件在 MySQL 8.0.21+ 是否默认启用?
不是,默认禁用。MySQL 8.0.17 引入 clone_plugin,但直到 8.0.25 仍不自动安装;8.0.21 同样需要手动加载。未启用时执行 CLONE INSTANCE 会报错:ERROR 3864 (HY000): Clone plugin is not installed。
实操建议:
- 检查是否已加载:
SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'clone'; - 若返回空,需在服务端执行:
INSTALL PLUGIN clone SONAME 'mysql_clone.so'; - 该操作需
SUPER或SYSTEM_VARIABLES_ADMIN权限,且仅对当前实例生效(重启后失效),建议写入配置文件:plugin_load_add = mysql_clone.so到my.cnf的[mysqld]段 -
mysql_clone.so文件必须存在于plugin_dir路径下(可通过SHOW VARIABLES LIKE 'plugin_dir';查看)
远程克隆(Remote Clone)要求哪些前置条件?
远程克隆是扩容主从或新建节点最常用方式,但限制比本地克隆严格得多,容易卡在连接或权限环节。
关键检查点:
- 源与目标 MySQL 版本必须完全一致(如都是 8.0.21,补丁号也需相同),否则报错:
ERROR 3869 (HY000): Clone Donor and Recipient versions do not match - 目标实例必须为空数据目录(
datadir下不能有ibdata1、mysql库等),否则报错:ERROR 3866 (HY000): Clone directory is not empty - 源端需开启克隆用户并授权:
CREATE USER 'cloner'@'%' IDENTIFIED BY 'xxx'; GRANT BACKUP_ADMIN ON *.* TO 'cloner'@'%'; FLUSH PRIVILEGES;—— 注意不是REPLICATION SLAVE,也不是ALL PRIVILEGES - 目标端需配置
clone_valid_donor_list,例如:SET GLOBAL clone_valid_donor_list = '192.168.1.10:3306';,否则报错:ERROR 3868 (HY000): Invalid donor
CLONE INSTANCE 执行时为什么卡住不动?
常见于网络慢、磁盘 IO 高或参数未调优,不是失败,而是静默等待。典型现象是客户端长时间无响应,SHOW PROCESSLIST 显示状态为 Clone Donor State 或 Clone Recipient State,但进度不更新。
排查和优化方向:
- 确认源端无大事务或 DDL 正在运行(克隆期间源库可读写,但长事务会拖慢快照获取)
- 检查目标端磁盘空间是否充足(克隆会先下载全量数据到临时目录
clone_dir,再重放,需预留 2 倍原datadir空间) - 调整克隆并发线程数(默认 1):
SET GLOBAL clone_max_concurrent_threads = 4;,适用于 SSD 或 NVMe 环境 - 若走局域网,关闭加密可提速(仅限可信内网):
SET GLOBAL clone_ssl_mode = 'DISABLED';,否则默认启用 TLS 加密传输
克隆后如何快速接入主从或 MGR?
克隆生成的是完整、一致的物理副本,包含最新的 binlog 位置和 GTID,但不会自动配置复制关系——这点常被忽略,导致“克隆完了却没法同步”。
正确衔接步骤:
- 克隆完成后,目标实例自动重启(这是设计行为,无需干预),启动后立即查:
SELECT * FROM performance_schema.clone_status\G,确认STATE为Completed - 查看克隆附带的复制坐标:
SELECT BINLOG_FILE, BINLOG_POSITION, GTID_EXECUTED FROM performance_schema.clone_status; - 若接传统主从:在目标端执行
CHANGE MASTER TO MASTER_HOST='xxx', ..., MASTER_LOG_FILE='xxx', MASTER_LOG_POS=xxx;,然后START SLAVE; - 若接 MGR:确保
group_replication_group_name与原集群一致,并跳过克隆节点的group_replication_start_on_boot=OFF,首次启动后手动执行START GROUP_REPLICATION;
注意:克隆不复制用户密码哈希(尤其是 8.0+ caching_sha2_password 插件用户),目标实例的 mysql.user 表中密码字段为空或占位符,需单独同步或重置。


















