如何在MySQL8.0中通过Clone Plugin快速同步节点数据-mysql教程-PHP中文网

clone instance 是物理快照拷贝而非同步，执行后目标实例自动重启停机5–15秒且不保留复制链路；需确保clone插件永久激活、双向配置权限与网络、克隆后手动清理auto.cnf并校准server_uuid等关键项。

如何在mysql8.0中通过clone plugin快速同步节点数据

CLONE INSTANCE 不是同步，而是物理快照拷贝——执行完目标实例自动重启停机 5–15 秒，且不保留复制链路。真要“快速同步节点数据”，你得先接受它不是主从复制的替代品，而是建从库或迁移的加速器。

确认 clone 插件已 ACTIVE 且永久加载

90% 的 CLONE INSTANCE 失败卡在这一步，报错如 ERROR 1126 (HY000): Can't open shared library 'mysql_clone.so' 或直接提示 Unknown command 'CLONE'，根本不是权限或网络问题。

登录后立刻执行：SELECT PLUGIN_NAME, PLUGIN_STATUS FROM INFORMATION_SCHEMA.PLUGINS WHERE PLUGIN_NAME = 'clone';，结果必须是 ACTIVE
INSTALL PLUGIN clone SONAME 'mysql_clone.so'; 只在当前会话生效，MySQL 重启即失效
永久生效必须改 my.cnf：
```
[mysqld]
plugin-load-add = mysql_clone.so
clone = FORCE_PLUS_PERMANENT
```
（Linux 下文件名是 mysql_clone.so，Windows 是 mysql_clone.dll）
改完必须 systemctl restart mysqld；reload 不触发插件重载
检查 SELECT @@plugin_dir; 路径下是否存在该文件，且 mysql 用户有读+执行权限（chmod 755）

远程克隆必须 donor 和 recipient 双向配齐三要素

远程克隆失败 80% 出在单边配置：只在 donor 装插件、只在 recipient 开权限、只设 donor 白名单，任缺其一都会静默卡住或报 ERROR 3864 (HY000): Clone Donor connection failed。

MySQL

编写正确的MySQL查询，避免字符集、索引和锁方面的常见陷阱。

下载

两端都必须在 my.cnf 中永久加载插件（同上）
donor 端用户（如 'clone_donor'@'192.168.10.5'）需：BACKUP_ADMIN（必需）、REPLICATION SLAVE（后续配主从用）
recipient 端用户（如 'clone_recip'@'localhost'）需：CLONE_ADMIN（隐含 SHUTDOWN，因克隆完要自动重启）
recipient 必须提前执行：SET GLOBAL clone_valid_donor_list = '192.168.10.5:3306';（不能带 http://，不支持 IPv6）
donor 的 bind_address 不能是 127.0.0.1，得设为 0.0.0.0 或具体内网 IP，并放行防火墙/云安全组的 3306 端口

克隆完成后必须手动清理 auto.cnf 并校准 server_uuid

克隆是物理拷贝，auto.cnf、server_uuid、gtid_executed 全部原样复制——不处理，新实例启动失败或主从直接冲突。

recipient 启动前，必须删掉 /var/lib/mysql/auto.cnf（Linux），让 MySQL 重启时重生成 server_uuid
启动后第一件事：SELECT @@server_uuid;，确认和 donor 不同；若相同，说明 auto.cnf 没删干净
手动更新 my.cnf：确保 server_id 唯一、gtid_mode = ON、log_bin 开启（如果要做主从）
CLONE INSTANCE 只复制 gtid_executed 快照，不启动复制线程、不写 master.info、不设置 SOURCE_HOST，后续 CHANGE REPLICATION SOURCE TO 全得你补

本地克隆失败，90% 是目录权限或空间问题

CLONE LOCAL DIRECTORY 是本地克隆唯一合法命令，禁止用 CLONE INSTANCE 在本机自克隆——它设计上禁止 donor 和 recipient 为同一进程，连 127.0.0.1:3306 都会触发循环检测失败。

目标路径必须**不存在**：/backup/clone_20260905，不能是 /var/lib/mysql 或其子目录，否则报 Directory overlaps with data directory
创建后立即执行：chown -R mysql:mysql /backup/clone_20260905，仅改父目录属主不够，子目录和文件也要递归归属
磁盘剩余空间必须 ≥ 当前 datadir 实际占用（用 du -sh /var/lib/mysql 看），CLONE 不压缩、不去重
大库（>50GB）克隆慢？可调大 clone_buffer_size（默认 4MB），加到 my.cnf：clone_buffer_size = 32M（仅对本地克隆生效）

真正容易被忽略的点是：克隆完你以为能直接连上 donor 做主从，但 server_uuid 冲突会让 CHANGE REPLICATION SOURCE TO 直接拒绝；而这个冲突不会在克隆时报错，只会等你启动复制时才爆发。删 auto.cnf 这一步，必须手动、必须在 recipient 启动前、必须确认删干净。