XtraBackup 8.x 必须与 MySQL 8.0 小版本严格匹配,否则拒绝连接;需检查并统一版本、设置备份目录权限为 mysql 用户、预留足够磁盘空间、确保增量链完整、校验 binlog_checksum 兼容性。

必须先确认 XtraBackup 8.x 与 MySQL 8.0 的小版本号完全一致,否则 xtrabackup 直接拒绝连接,报错 unsupported server version。
检查 MySQL 和 XtraBackup 版本是否严格匹配
MySQL 8.0 不是统一体系——8.0.28、8.0.30、8.0.33 等子版本各自对应唯一可用的 percona-xtrabackup-80 包。混用会导致备份中断或元数据损坏。
- 查 MySQL 版本:
mysql --version或SELECT VERSION(); - 查已安装 XtraBackup 版本:
xtrabackup --version(注意不是innobackupex,该命令在 8.0+ 已废弃) - 若不一致,必须卸载旧版:
yum remove percona-xtrabackup-80(CentOS)或apt purge percona-xtrabackup-80(Ubuntu),再按对应版本重装
确保 MySQL 运行用户对备份目录有完整权限
物理备份会写入大量临时文件和 .qp/.zst 压缩包,xtrabackup 默认以当前 shell 用户身份执行,但备份目标目录(如 /backup/mysql)必须能被 MySQL 进程用户(通常是 mysql)读取——因为恢复时需校验 ibdata1 和 redo log。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录,或需要将该能力封装成可公开复用的 Codex skill。
- 创建专用备份目录:
mkdir -p /backup/mysql - 设属主为
mysql:chown -R mysql:mysql /backup/mysql - 禁止其他用户写入:
chmod 750 /backup/mysql - 验证:
sudo -u mysql touch /backup/mysql/test应成功;若失败,说明 SELinux 或 AppArmor 正在拦截(CentOS 7 需setsebool -P mysqld_disable_trans 1;Ubuntu 需sudo aa-complain /usr/sbin/mysqld)
预留足够磁盘空间并禁用自动清理策略
增量备份依赖上一次全备的 LSN 基线,所有增量包必须保留完整链路。一个典型错误是 cron 脚本只删「7 天前」的目录,却没判断其中是否含未被后续增量引用的全备。
- 计算空间余量:全备大小 × 1.2 +(日均增量 × 保留天数 × 1.5);例如全备 40GB,日增 2GB,保留 14 天 → 至少预留
40×1.2 + 2×14×1.5 = 90GB - 备份目录所在分区不能与
/var/lib/mysql共用:避免因备份填满根分区导致 MySQL 崩溃 - 脚本中删除逻辑必须检查
mysql_increment_hot_backup.index文件,确认某次全备未被任何增量条目引用后,才可删除其目录
最容易被忽略的是:MySQL 8.0 默认启用 binlog_checksum = CRC32,而老版本 XtraBackup 若未打补丁,会在 apply-log 阶段校验失败。务必确认你用的 xtrabackup 二进制文件编译时间晚于 2022 年,或直接从 Percona 官网下载带 8.0.x 后缀的 RPM/DEB 包——别信第三方镜像源里的“latest”软链接。










