MySQL 8中binlog自动过期依赖binlog_expire_logs_seconds(推荐,默认30天)和binlog_expire_logs_auto_purge(默认ON),expire_logs_days已弃用;参数优先级为后者>前者>旧参数,且自动清理仅在启动、flush logs或binlog轮转时触发。

这里有个关键版本分水岭:MySQL 8.0.26 及之后的版本才支持 expire_logs_seconds 这个新参数。如果你用的是旧版本,包括所有的 MySQL 5.7 和大部分 8.0 的早期版本,那就还得继续用老的 expire_logs_days。在旧版本里直接设置 expire_logs_seconds,系统要么报错,要么直接忽略你的指令。
为什么 set global expire_logs_seconds 不生效
很多朋友遇到一个典型问题:明明执行了 SET GLOBAL expire_logs_seconds = 604800,但回头一看,设置好像没生效。这十有八九是踩了下面几个坑:
- 首要原因:你的 MySQL 版本低于 8.0.26。比如还在用 8.0.23 或者 5.7.39,那这个变量压根就不存在。
- 手误拼错了变量名,比如写成了
expire_log_seconds或者expire_binlog_seconds。 - 检查方法不对。只看了
expire_logs_days的值,没用SHOW VARIABLES LIKE 'expire%'这个命令去全面排查一下。
所以,最靠谱的诊断步骤就两步:先运行 SELECT VERSION(); 确认版本,再用 SHOW VARIABLES LIKE 'expire%'; 看看相关变量到底有哪些、值是什么。
旧版本只能用 expire_logs_days,且修改后不立即清理
expire_logs_days 虽然兼容性最广,但用起来有几个关键限制必须心里有数:
- 它只是个“过期阈值”触发器,不是定时任务。别指望 MySQL 会在每天零点自动删文件。它只会在特定时刻检查并清理,比如手动执行
FLUSH LOGS、实例重启、或者当前 binlog 文件大小达到max_binlog_size触发轮转时。 - 默认值是 0,但这“0”可不代表立刻删除,而是意味着“永不过期”。生产环境要是设成 0,磁盘被 binlog 撑爆只是时间问题。
- 修改这个参数后,清理动作不会立刻发生。如果当前 binlog 文件还很小,可能很久都不会轮转。这时候,手动触发一次
FLUSH LOGS是加速清理进程的有效方法。
举个例子,如果你想设置保留7天,应该这样操作:
SET GLOBAL expire_logs_days = 7; FLUSH LOGS;
MySQL 8.0.26+ 正确使用 expire_logs_seconds
新参数 expire_logs_seconds 以秒为单位,控制粒度更精细了,但核心逻辑没变——依然依赖日志轮转来触发清理。使用时务必注意以下几点:
- 优先级陷阱:必须同时把
expire_logs_days设为 0(即取消设置)。因为如果expire_logs_days有非零值,它的优先级更高,expire_logs_seconds就直接失效了。 - 持久化配置:建议在 my.cnf 或 my.ini 配置文件中设置,避免实例重启后配置丢失。配置示例如下:
[mysqld]expire_logs_days = 0expire_logs_seconds = 604800 - 取值限制:不能设为负数或非整数,其最小有效值通常是 3600 秒(也就是1小时)。
设置完成后,记得验证一下:
SHOW VARIABLES LIKE 'expire_logs%';
成功的输出应该是:expire_logs_seconds 显示为你设置的非零值,而 expire_logs_days 的值显示为 0。
真正要删 binlog,别只靠参数
无论你用新参数还是旧参数,自动清理都存在延迟。如果遇到磁盘空间告急,需要立刻释放空间,就得主动出击,使用手动清理命令:
- 按文件名清理:
PURGE BINARY LOGS TO 'mysql-bin.000055';(会删除指定文件之前的所有 binlog) - 按时间点清理:
PURGE BINARY LOGS BEFORE '2026-04-05 00:00:00';(这里要特别注意服务器时区问题) - 清理后务必执行
SHOW BINARY LOGS;确认结果,尤其要避免误删那些还在被使用的日志,比如主从同步中,从库还没读取完的 binlog。
最后提个醒:PURGE 操作是不可回滚的,并且在执行期间会阻塞后续的 DDL 和 DML 语句,直到清理完成。所以,如果要清理的 binlog 文件很大,务必选择在业务低峰期操作。
