mysql主从复制架构中，从库的IO线程会从主库拉取二进制日志并写入本地的中继日志，SQL线程再读取中继日志执行数据同步操作。中继日志默认不会自动清理，长期运行会占用大量磁盘空间，relay_log_purge参数就是用来控制mysql是否自动清理已执行完成的中继日志，下文将详细介绍该参数的配置方法。
relay_log_purge参数说明
relay_log_purge是mysql的动态全局参数，取值为0或1：
- 值为1时，mysql会自动清理已经执行完成且不再需要的中继日志，这是默认开启的状态，适合大多数主从复制场景。
- 值为0时，mysql不会自动清理中继日志，需要用户手动执行清理操作，通常仅在特殊运维场景下使用。
需要注意的是，该参数仅对从库生效，主库上配置该参数没有实际意义。
临时配置relay_log_purge参数
临时配置不需要重启mysql服务，修改后立即生效，但mysql服务重启后会恢复为配置文件中的设置，适合临时调整场景。
查看当前参数值
先执行以下命令查看当前relay_log_purge参数的取值：
-- 查看relay_log_purge参数当前值 SHOW GLOBAL VARIABLES LIKE 'relay_log_purge';
开启自动清理
如果当前值为OFF或者0，执行以下命令开启自动清理：
-- 设置relay_log_purge为开启状态 SET GLOBAL relay_log_purge = 1;
关闭自动清理
如果需要临时关闭自动清理，执行以下命令即可：
-- 设置relay_log_purge为关闭状态 SET GLOBAL relay_log_purge = 0;
永久配置relay_log_purge参数
永久配置需要修改mysql的配置文件，修改后需要重启mysql服务才能生效，适合长期固定配置的场景。
修改配置文件
找到mysql的配置文件，通常是my.cnf（Linux系统）或者my.ini（Windows系统），在[mysqld]配置段下添加或修改以下配置：
[mysqld] # 开启中继日志自动清理，取值为1表示开启，0表示关闭 relay_log_purge=1
重启mysql服务
修改完成后保存配置文件，重启mysql服务使配置生效：
- Linux系统执行命令：
systemctl restart mysqld或者service mysqld restart - Windows系统可以在服务管理器中重启mysql服务，或者执行命令：
net stop mysql & net start mysql
验证配置生效
重启完成后，再次执行查看参数的命令，确认取值已经变为ON或者1：
SHOW GLOBAL VARIABLES LIKE 'relay_log_purge';
配置注意事项
- 如果从库开启了
relay_log_recovery参数，建议同时开启relay_log_purge，避免中继日志恢复时出现异常。 - 手动清理中继日志时，不要直接删除中继日志文件，应该先执行
STOP SLAVE;停止复制线程，再执行RESET SLAVE;清理中继日志，最后再启动复制线程，避免复制中断。 - 如果主从复制出现延迟，不建议关闭
relay_log_purge，因为延迟时中继日志会持续堆积，关闭自动清理会更快占满磁盘。
常见问题排查
如果配置完成后中继日志仍然没有自动清理，可以按照以下步骤排查：
- 确认参数是否真的生效，执行
SHOW GLOBAL VARIABLES LIKE 'relay_log_purge';查看当前取值。 - 确认从库的SQL线程是否正常运行，只有SQL线程执行完的中继日志才会被自动清理，如果SQL线程异常，中继日志不会触发清理。
- 检查是否有其他进程在读取中继日志文件，如果有外部进程占用，mysql可能无法完成自动清理操作。
mysqlrelay_log_purge中继日志relay_log修改时间：2026-06-26 02:15:20