relay_log_recovery=ON是生产环境必需配置,用于宕机后强制从主库重拉binlog并重放,避免因relay log损坏导致事务丢失;其生效需满足repository为TABLE且完整重启。

relay_log_recovery=ON 是防止从库宕机后丢数据的兜底机制
MySQL 8.0 主从复制中,relay_log_recovery 不是“可选优化项”,而是应对意外宕机时 relay log 损坏或不完整的关键开关。它默认为 OFF,但生产环境必须显式设为 ON——否则从库重启后可能跳过未执行的 relay log,直接从新位置拉 binlog,导致事务丢失、主从不一致。
文件删除恢复功能 v0.8.0:删除前自动备份文件(存至 `delete_backup/YYYYMMDDHHMM/` 目录),支持从备份中恢复、通过清单(manifest)搜索。具备 SHA256 完整性校验、路径遍历防护及工作区根目录(workspace-root)访问限制。支持自动清理 7 天 / 30 天前的备份。 **v0.8.0:新增 `workspace_cleaner` —— 支持定时清理临时文件,并在删除前自动执行备份。** **v0.7.0:`allowed_roots` 默认值
为什么 OFF 会导致静默丢数据
当 relay_log_recovery=OFF 时,mysqld 启动只按 mysql.slave_relay_log_info 表(或旧版 relay-log.info 文件)里记录的位置恢复 SQL 线程。但如果:
- 从库异常断电或 kill -9,relay log 写到一半就中断
- 磁盘满、SELinux 拦截、权限错误导致 relay log 文件写失败
- 升级后元数据格式不兼容(如从 FILE 切 TABLE 模式但没重置)
那么 Exec_Master_Log_Pos 指向的位置,实际对应的 relay log 已损坏或不存在。SQL 线程会直接报错卡住,或更危险地——跳过该段,从下一个合法 position 继续,漏掉中间事务。
ON 模式下真正发生了什么
relay_log_recovery=ON 生效有硬性前提,缺一不可:
- relay_log_info_repository 和 master_info_repository 都必须为 TABLE(不是默认的 FILE)
- mysqld 必须完整重启(systemctl restart mysql),reload 不触发 recovery 流程
满足后,启动时会:
- 放弃所有现有 relay log 文件(不管是否损坏)
- 清空 mysql.slave_relay_log_info 表中的 relay log 文件名和偏移
- 让 I/O 线程从 mysql.slave_master_info 记录的 Master_Log_File/Master_Log_Pos 重新拉取 binlog,并写入新 relay log
- SQL 线程自动对齐到 I/O 线程当前位置,从头重放
这样确保“拉到的都执行”,不依赖本地 relay log 的完整性。
常见误操作和验证要点
别以为开了 ON 就万事大吉,这些坑最常踩:
- 直接删 relay-log.info 或 master.info 文件:在 TABLE 模式下它们已失效,删了反而让位置信息丢失,导致 CHANGE MASTER TO 失败
- 升级 MySQL 后没跑 mysql_upgrade:系统表结构不匹配,RESET SLAVE ALL 可能失败,SHOW SLAVE STATUS 报 ER_RPL_RECOVERY_ERROR_READ_RELAY_LOG
- 忘记检查磁盘权限:/var/lib/mysql/ 下 relay log 文件属主必须是 mysql:mysql,否则 recovery 阶段写新 relay log 会因权限拒绝失败
验证是否真生效:重启后执行 SHOW VARIABLES LIKE 'relay_log_recovery'; 确认值为 ON,再看 SHOW SLAVE STATUS\G 中 Relay_Log_File 是否变成新文件名(如 hostname-relay-bin.000001),而非沿用旧编号

















