MySQL主从复制架构中，从库的IO线程会从主库拉取binlog事件，先写入本地的Relay Log中继日志，再由SQL线程读取Relay Log执行对应的数据变更操作。Relay Log默认不会无限保留，MySQL提供了relay_log_purge参数来控制过期Relay Log的自动清理逻辑。
Relay Log的基本特性
Relay Log的文件格式和binlog类似，同样由索引文件和日志文件组成，默认存储在MySQL的数据目录下，文件名通常以relay-bin开头。正常情况下，SQL线程执行完Relay Log中的所有事件后，这些日志就可以被清理，避免占用不必要的磁盘空间。
如果Relay Log没有及时清理，当磁盘空间被占满时，从库的IO线程和SQL线程都会停止工作，主从复制就会中断，因此管理Relay Log的清理策略非常重要。
relay_log_purge参数的作用与配置
relay_log_purge是MySQL的一个全局动态参数，专门用于控制从库是否自动清理已经执行完成的Relay Log，默认值为ON，也就是开启自动清理。
参数查看方式
可以通过以下SQL语句查看当前relay_log_purge的参数值：
-- 查看relay_log_purge参数当前值 SHOW GLOBAL VARIABLES LIKE 'relay_log_purge';
执行后如果返回的结果是relay_log_purge | ON，说明自动清理功能已经开启。
参数修改方式
该参数是动态参数，不需要重启MySQL实例就可以修改，修改方式如下：
-- 临时开启自动清理，重启后失效 SET GLOBAL relay_log_purge = ON; -- 临时关闭自动清理，重启后失效 SET GLOBAL relay_log_purge = OFF;
如果需要永久生效，需要修改MySQL的配置文件my.cnf，在[mysqld]区块下添加配置：
[mysqld] relay_log_purge = ON
修改完成后重启MySQL实例即可永久生效。
自动清理的工作逻辑
当relay_log_purge参数开启时，MySQL会在SQL线程执行完一个Relay Log文件中的所有事件后，自动删除该Relay Log文件。具体的清理逻辑遵循以下规则：
- 只会清理已经被SQL线程完全执行完成的Relay Log文件，未执行完成的文件不会被删除，避免数据丢失。
- 清理操作是异步进行的，不会阻塞SQL线程的正常执行。
- 如果同时开启了
relay_log_recovery参数，MySQL在从库重启时会自动重新拉取缺失的Relay Log，不会影响自动清理逻辑。
手动清理Relay Log的注意事项
如果因为特殊原因需要手动清理Relay Log，不能直接删除磁盘上的Relay Log文件，否则会导致从库复制报错。正确的手动清理方式是通过MySQL内置的命令操作：
-- 手动删除所有已经执行完成的Relay Log，并重新生成新的Relay Log RESET SLAVE RELAY LOG;
需要注意，执行RESET SLAVE RELAY LOG命令会清空从库的复制元数据中的Relay Log相关信息，执行前需要确认当前从库的复制状态，避免误操作导致复制中断。
常见问题说明
有些用户会遇到relay_log_purge已经开启，但是Relay Log没有被自动清理的情况，通常有以下两种原因：
- SQL线程没有正常运行，导致Relay Log中的事件没有被完全执行，MySQL不会清理未执行完成的日志。
- 从库存在延迟，Relay Log中的事件还在等待SQL线程执行，此时也不会触发清理。
这种情况下需要先排查从库复制延迟或者SQL线程异常的问题，修复后再观察Relay Log的清理情况，不要直接手动删除日志文件。
MySQLRelay_Logrelay_log_purge主从复制修改时间：2026-07-08 19:36:24