MySQL 8 二进制日志(binlog)自动过期设置方法_Mysql

一、核心过期管理参数解析

mysql 8 中 binlog 过期管理主要依赖 3 个核心参数，其中 expire_logs_days 已被弃用，推荐使用新参数 binlog_expire_logs_seconds 和 binlog_expire_logs_auto_purge，具体说明如下：

参数名称	状态	默认值	功能说明
`binlog_expire_logs_seconds`	推荐使用	2592000 秒（30 天）	设定 binlog 过期时间（单位：秒），过期后文件可被自动删除。删除触发时机：数据库启动时、执行 `flush logs` 时、binlog 大小超过 `max_binlog_size` 时。
`binlog_expire_logs_auto_purge`	推荐使用	on（启用）	控制 binlog 自动清除功能的开关：on 启用自动清除，off 禁用。优先级高于 `binlog_expire_logs_seconds`，即使设置了过期时间，禁用后也不会自动删除。
`expire_logs_days`	已弃用	无（依赖前者）	旧版过期时间参数（单位：天），mysql 8 中已不推荐使用，未来将被移除，仅为兼容早期版本保留。

关键参数依赖规则（重点！）

参数优先级：binlog_expire_logs_auto_purge > binlog_expire_logs_seconds > expire_logs_days。
冲突处理：
- 若同时设置 binlog_expire_logs_seconds 和 expire_logs_days 为非零值，仅生效 binlog_expire_logs_seconds，并抛出警告。
- 运行时若其中一个参数为非零值，无法直接将另一个设为非零值（需先将当前非零值设为 0）。
禁用自动清除的两种场景：
- mysql 8.0.29+ 版本：直接设置 binlog_expire_logs_auto_purge = off（推荐，优先级最高）。
- mysql 8.0.28 及更早版本：需设置 binlog_expire_logs_seconds = 0，且不设置 expire_logs_days；或仅设置 expire_logs_days = 0（兼容旧版）。

二、binlog 自动过期配置方法

1. 临时配置（仅当前数据库实例有效，重启失效）

场景 1：自定义 binlog 过期时间（如 7 天）

-- 7天 = 7*24*60*60 = 604800 秒
set global binlog_expire_logs_seconds = 604800;
-- 确保自动清除功能启用（默认已启用，无需修改，此处为验证）
set global binlog_expire_logs_auto_purge = on;

场景 2：禁用 binlog 自动清除（保留所有 binlog）

-- mysql 8.0.29+ 版本（推荐）
set global binlog_expire_logs_auto_purge = off;
-- mysql 8.0.28 及更早版本
set global binlog_expire_logs_seconds = 0;
-- 注意：此时不可设置 expire_logs_days 为非零值

2. 永久配置（重启数据库后生效，生产环境推荐）

需修改 mysql 配置文件（通常为 my.cnf 或 my.ini），不同系统路径可能不同（linux 常见路径：/etc/my.cnf，windows 常见路径：c:\programdata\mysql\mysql server 8.0\my.ini）：

编辑配置文件：

vim /etc/my.cnf  # linux 系统

添加 / 修改以下配置项（根据需求选择）：

场景 1：设置 binlog 7 天后自动过期（生产环境常用）

[mysqld]
# 启用 binlog（若未启用，需先开启）
log_bin = /var/lib/mysql/mysql-bin
# 设置过期时间为 7 天（604800 秒）
binlog_expire_logs_seconds = 604800
# 启用自动清除（默认 on，可省略）
binlog_expire_logs_auto_purge = on

场景 2：禁用 binlog 自动清除（如需要长期保留日志）

[mysqld]
log_bin = /var/lib/mysql/mysql-bin
# mysql 8.0.29+ 版本
binlog_expire_logs_auto_purge = off
# mysql 8.0.28 及更早版本
binlog_expire_logs_seconds = 0

保存配置文件后，重启 mysql 服务使配置生效：

# linux 系统（centos/rhel）
systemctl restart mysqld
# linux 系统（ubuntu/debian）
systemctl restart mysql
# windows 系统（命令行）
net stop mysql80 && net start mysql80

3. 验证配置是否生效

-- 查看核心参数配置
show global variables like 'binlog_expire_logs_%';
show global variables like 'expire_logs_days';

若输出结果与配置值一致（如 binlog_expire_logs_seconds = 604800），说明配置生效。

三、手动清理 binlog（补充方案）

若需立即清理过期或指定 binlog 文件，可使用 purge binary logs 命令（无需等待自动清除），常用用法如下：

清理指定日期之前的 binlog：

-- 清理 2024-05-01 00:00:00 之前的所有 binlog
purge binary logs before '2024-05-01 00:00:00';

清理指定文件名之前的 binlog：

-- 先查看当前 binlog 文件列表
show binary logs;
-- 清理到 mysql-bin.000100 之前的文件（不包含该文件）
purge binary logs to 'mysql-bin.000100';

注意：手动清理时需避免删除正在使用的 binlog 文件（当前日志文件可通过 show master status 查看），否则可能导致主从复制失败或数据恢复异常。

四、生产环境配置建议与注意事项

合理设置过期时间：
- 主从复制场景：需确保 binlog 过期时间长于从库同步延迟，避免主库提前删除从库未同步的 binlog（建议至少保留 3-7 天）。
- 单实例场景：根据存储空间大小设置，若日均 binlog 生成量较大，可缩短至 1-3 天。
禁用自动清除的场景：数据备份周期较长、需要长期审计日志的场景，禁用后需定期手动清理，避免存储空间耗尽。
避免混用新旧参数：尽量使用 binlog_expire_logs_seconds 和 binlog_expire_logs_auto_purge，避免依赖已弃用的 expire_logs_days，防止未来版本升级时兼容性问题。
监控 binlog 存储：定期检查 binlog 存储目录大小（默认路径：/var/lib/mysql/），若发现自动清理未生效，需排查参数配置或日志文件权限。
权限要求：修改全局参数（set global）或编辑配置文件需具备 super 权限（如 root 用户），普通用户无权限操作。