必须关掉从库并清空datadir及log_bin目录,否则因ibdata1、mysql.ibd或旧relay-log冲突导致90%同步失败;主库备份须加--slave-info和--no-lock,恢复需--apply-log与--copy-back两步,且必须删除auto.cnf以避免server-uuid冲突。

直接用 xtrabackup 搭建 MySQL 8.0 主从节点,核心不是“能不能”,而是“必须关掉从库再清空数据目录”——跳过这步,90% 的同步失败都源于残留的 ibdata1、mysql.ibd 或旧 relay-log 文件冲突。
主库备份时必须加 --slave-info 和 --no-lock
MySQL 8.0 默认启用 LOCK INSTANCE FOR BACKUP,但该语句在某些高并发场景下会卡住 DDL 或长事务。不加 --no-lock 可能导致备份挂起数分钟甚至超时;不加 --slave-info 则无法在备份中自动记录 MASTER_LOG_FILE 和 MASTER_LOG_POS(或 GTID set),后续 CHANGE MASTER TO 就得手动查,极易出错。
-
--slave-info会把主库当前 binlog 位点写入备份目录下的xtrabackup_slave_info文件,这是从库启动复制的唯一可信依据 -
--no-lock跳过FLUSH TABLES WITH READ LOCK,但要求所有表都是 InnoDB;MyISAM 表仍需锁(所以生产环境应避免 MyISAM) - GTID 模式下,
--slave-info输出的是SET GLOBAL gtid_purged=...语句,而非文件+位置,这点和传统模式完全不同
从库恢复前必须停服务 + 彻底清空 datadir 和 log_bin 目录
很多人只删 datadir 下的文件,却忘了 log_bin 目录里还存着旧的 mysql-bin.000001 等文件——这些残留 binlog 会被从库误认为是自己生成的,导致 START SLAVE 后报错 Got fatal error 1236 from master when reading data from binary log。
- 执行
systemctl stop mysqld(或/etc/init.d/mysql.server stop),不能只杀进程 - 确认
datadir(如/var/lib/mysql)和log_bin配置路径(如/var/log/mysql/mysql-bin.log对应的目录)全部清空,rm -rf后用ls验证为空 - 不要试图“保留
mysql库”——XtraBackup 恢复后会重建系统库,保留反而引发权限表不一致
恢复命令必须带 --apply-log 和 --copy-back 两步
流式备份(--stream=xbstream)或压缩包解压后的备份集,只是原始文件快照,未合并 redo 日志,直接启动 mysqld 必然崩溃。必须先 --apply-log 回滚未提交事务、重放已提交事务,再 --copy-back 到真实 datadir。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 第一步:
xtrabackup --defaults-file=/etc/my.cnf --apply-log --target-dir=/data/backup/2026-11-04_18-00-00 - 第二步:
xtrabackup --defaults-file=/etc/my.cnf --copy-back --target-dir=/data/backup/2026-11-04_18-00-00 - 执行完
--copy-back后,必须chown -R mysql:mysql /var/lib/mysql,否则 mysqld 启动报错Can't start server: can't read dir of '/var/lib/mysql/'
启动复制前要检查 server-id 和 GTID 设置是否匹配
主从 server-id 冲突会导致 IO 线程拒绝连接;GTID 模式下若从库 gtid_mode=OFF 却用了 --slave-info 生成的 gtid_purged,START SLAVE 会直接报错 ERROR 1840 (HY000)。
- 主库查:
SHOW VARIABLES LIKE 'server_id'; SHOW VARIABLES LIKE 'gtid_mode'; - 从库
/etc/my.cnf中必须显式设置不同server-id(如主库是 1,从库至少为 2),且gtid_mode值必须与主库完全一致(大小写敏感) - GTID 模式下,恢复后首次启动前,必须执行
SET GLOBAL gtid_purged='xxx-xxx-xxx:1-100';(内容来自xtrabackup_slave_info),否则复制无法初始化
最容易被忽略的是:XtraBackup 8.0 恢复后,auto.cnf 里的 server-uuid 是从主库拷贝过来的,从库启动时会因 UUID 冲突拒绝加载。必须删掉从库 datadir 下的 auto.cnf,让 mysqld 启动时自动生成新 UUID——否则 SHOW SLAVE STATUS\G 里 Slave_IO_Running 永远是 Connecting。










