MySQL 8.0 Clone插件快速同步副本数据指南

CLONE INSTANCE 这个功能，本质上是一次物理快照拷贝，而非持续同步。执行完成后，目标实例会自动重启，停机时间大约 5 到 15 秒，此后不再具备后续复制能力。它的定位非常清晰——快速搭建从库、灾备重建，但不能替代主从复制或 GTID 同步。优点是速度快，缺点是仅限一次性使用。 不过，想要成功运行这个快照，有几个关键点必须严格把控，否则不是报错就是启动失败，甚至引发主从冲突。下面逐一说明。 ### 插件必须保持 ACTIVE 且永久加载，否则命令直接报错 很多运维人员在线上遇到 `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` 持久化： ```ini [mysqld] plugin-load-add = mysql_clone.so clone = FORCE_PLUS_PERMANENT ``` 然后执行 `systemctl restart mysqld`（注意 `reload` 无效）。文件名务必区分：Linux 下为 `mysql_clone.so`，Windows 下为 `mysql_clone.dll`，切勿混淆。 ### 远程克隆需分别在 donor 和 recipient 上配置权限和白名单 克隆并非一个账号通吃两端。`CLONE INSTANCE` 是 recipient 主动拉取 donor 的数据，角色严格分离。 - **donor 端**：需要创建一个用户，例如 `'clone_donor'@'192.168.10.5'`，权限至少包含 `BACKUP_ADMIN`（必需），建议同时赋予 `REPLICATION SLAVE` 以方便后续配置主从。 - **recipient 端**：用户需拥有 `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 端口，否则 recipient 无法连接。 ### 克隆完成后必须手动清理 auto.cnf 并校准 server_uuid 克隆是物理拷贝，`auto.cnf`、`server_uuid`、`gtid_executed` 所有内容都会被原样复制过来。如果不处理，新实例启动时会因 `server_uuid` 冲突而失败，或者主从直接报错。 recipient 重启后第一件事： `rm -f /var/lib/mysql/auto.cnf` 让 MySQL 重启时自动生成新的 `server_uuid`。 然后检查 `SELECT @@server_uuid;`，确认与 donor 不同。如果相同，说明 `auto.cnf` 未删除干净。此外，还要手动调整 `my.cnf`：确保 `server_id` 唯一、`gtid_mode=ON`、`log_bin` 开启（如果后续要做主从）。千万不要指望克隆能自动恢复配置——`CLONE INSTANCE` 只覆盖数据目录，不修改配置文件。 ### 本地克隆前目标路径必须为空且属主正确 本地克隆并非将文件复制到已有目录，而是覆盖式重建整个数据目录结构。所以目标路径必须不存在，例如使用 `/data/clone_20260702` 而非 `/data/mysql`。创建目录后立即执行 `chown -R mysql:mysql /data/clone_20260702`，否则会报 `Cannot create directory: Permission denied`。 另外，`innodb_file_per_table=OFF` 的旧实例无法被克隆；recipient 如果仍启用该模式，会触发 `Invalid tablespace file` 错误。克隆期间 donor 上的任何 DDL 操作都会阻塞克隆，建议避开业务高峰期操作。 --- 总结一下，克隆后 `server_uuid` 冲突、`auto.cnf` 残留、权限跨端复用、插件未永久加载——这四个问题占了线上故障的九成以上。动手前先执行一遍 `SELECT PLUGIN_NAME, PLUGIN_STATUS ...`，比什么都管用。