MySQL 日志记录了数据库的运行状态、客户端操作和数据变更,是故障排查、SQL 优化、数据恢复及主从复制的重要依据。本文系统梳理 MySQL 8.0 常见日志,并给出查看和配置方法。
生产环境修改日志配置前,应评估磁盘空间、性能和敏感信息泄露风险。通用查询日志尤其不适合长期开启。
一、MySQL 8.0 日志体系
| 日志 | 主要用途 | 典型场景 |
|---|---|---|
| 错误日志(Error Log) | 记录服务器启动、运行、停止及严重错误 | 启动失败、异常退出、崩溃恢复 |
| 通用查询日志(General Query Log) | 记录客户端连接和服务器收到的语句 | 短时间审计与调试 |
| 慢查询日志(Slow Query Log) | 记录执行时间超过阈值的语句 | 定位性能较差的 SQL |
| 二进制日志(Binary Log) | 记录数据变更事件 | 复制、时间点恢复、审计变更 |
| Redo Log | 记录 InnoDB 页的物理变更 | 崩溃恢复、保证持久性 |
| Undo Log | 保存修改前的信息 | 事务回滚、MVCC 一致性读 |
| Relay Log | 副本保存从复制源接收的变更 | MySQL 主从复制 |
二、先查看当前日志配置
登录 MySQL 后,可以一次查看常用日志变量:
SHOW VARIABLES WHERE Variable_name IN ( 'datadir', 'log_error', 'general_log', 'general_log_file', 'slow_query_log', 'slow_query_log_file', 'long_query_time', 'log_output', 'log_bin', 'binlog_expire_logs_seconds' );
如果日志文件只配置了文件名而没有绝对路径,通常位于 datadir 数据目录中。实际位置应以变量查询结果为准,不要仅凭默认路径判断。
三、错误日志 Error Log
错误日志记录 mysqld 启动和关闭信息、配置错误、插件异常、表损坏提示以及 InnoDB 崩溃恢复过程。数据库无法启动时,应首先检查它。
SHOW VARIABLES LIKE 'log_error'; SHOW VARIABLES LIKE 'log_error_verbosity';
Linux 上还可结合服务管理器查看最近日志:
systemctl status mysqld journalctl -u mysqld --since today # 部分发行版服务名为 mysql journalctl -u mysql --since today
Windows 可在查询到的 log_error 路径查看文件,也可以检查 Windows 事件查看器。排错时重点关注时间、错误编号、组件名称和错误发生前后的上下文。
四、通用查询日志 General Query Log
通用查询日志会记录客户端连接以及服务器收到的语句,信息非常详细,但写入量大,可能影响性能并记录敏感数据,因此默认通常关闭,只建议短时间启用。
SHOW VARIABLES LIKE 'general_log%'; SHOW VARIABLES LIKE 'log_output'; SET GLOBAL log_output = 'FILE'; SET GLOBAL general_log = ON; -- 完成排查后立即关闭 SET GLOBAL general_log = OFF;
SET GLOBAL 的修改通常只对当前运行实例生效。需要重启后仍保留时,应写入 MySQL 配置文件,并在维护窗口重启验证。
五、慢查询日志 Slow Query Log
慢查询日志用于记录执行时间超过 long_query_time 的语句,是 SQL 性能优化的常用入口。
SHOW VARIABLES LIKE 'slow_query_log%'; SHOW VARIABLES LIKE 'long_query_time'; SHOW VARIABLES LIKE 'log_queries_not_using_indexes'; SET GLOBAL slow_query_log = ON; SET GLOBAL long_query_time = 2;
以上示例把阈值设置为 2 秒。新连接会使用新的会话值;排查完成后应根据业务恢复合理阈值。不要为了“抓全”而长期启用 log_queries_not_using_indexes,否则繁忙系统可能产生大量日志。
可以使用 mysqldumpslow 汇总慢日志:
mysqldumpslow -s t -t 10 /path/to/slow.log
该命令按执行时间排序,展示前 10 类慢 SQL。找到目标语句后,再结合 EXPLAIN 或 EXPLAIN ANALYZE 检查执行计划。
六、二进制日志 Binary Log
Binary Log,简称 Binlog,记录会造成数据变化的事件,主要用于复制和时间点恢复。它属于 MySQL Server 层,不等同于 InnoDB 的 Redo Log。
SHOW VARIABLES LIKE 'log_bin'; SHOW VARIABLES LIKE 'binlog_format'; SHOW VARIABLES LIKE 'binlog_expire_logs_seconds'; SHOW BINARY LOGS;
读取 Binlog 应使用 mysqlbinlog 工具,不要直接用文本编辑器打开:
mysqlbinlog mysql-bin.000001
mysqlbinlog --start-datetime="2026-11-13 10:00:00" \
--stop-datetime="2026-11-13 11:00:00" \
mysql-bin.000001
生产环境应设置合理的自动过期时间,并保证备份链完整。清理日志应使用 MySQL 提供的管理语句或自动过期机制,不要直接删除正在管理的 Binlog 文件。
七、Redo Log:崩溃恢复
Redo Log 是 InnoDB 的磁盘数据结构,记录数据页变更。当修改尚未完全写入数据文件就发生意外宕机时,InnoDB 会在启动过程中重放必要的 Redo,恢复到一致状态。
MySQL 8.0.30 及以上版本可通过以下变量查看 Redo Log 容量:
SHOW VARIABLES LIKE 'innodb_redo_log_capacity'; SHOW STATUS LIKE 'Innodb_redo_log%';
较早的 MySQL 8.0 版本使用 innodb_log_file_size 和 innodb_log_files_in_group。不同小版本的配置方式存在差异,调整前必须先确认版本:
SELECT VERSION();
八、Undo Log:回滚与 MVCC
Undo Log 保存事务修改前的信息,主要有两个作用:
- 事务执行 ROLLBACK 时,根据 Undo 撤销尚未提交的修改。
- 为 MVCC 一致性读构造旧版本数据,让查询在并发环境中读取合适的数据快照。
Undo 并不是普通的可读文本日志。长事务会阻止旧版本及时清理,可能造成 Undo 空间增长,因此应避免事务长时间不提交。
九、Relay Log:复制中继日志
Relay Log 存在于副本服务器。副本的 I/O 线程接收复制源的 Binlog 事件并写入 Relay Log,SQL 线程再读取并重放这些事件。
SHOW REPLICA STATUS\G
排查复制问题时,可重点关注 I/O 线程、SQL 线程状态,复制延迟以及最近一次错误。在较早版本或兼容环境中,也可能看到 SHOW SLAVE STATUS\G。
十、配置文件示例
下面仅作为配置结构示例,路径和阈值应根据系统环境调整:
[mysqld] # 错误日志 log_error=/var/log/mysql/error.log # 慢查询日志 slow_query_log=ON slow_query_log_file=/var/log/mysql/slow.log long_query_time=2 # Binlog 自动保留 7 天 binlog_expire_logs_seconds=604800
修改前应备份配置文件,确保日志目录存在且 MySQL 运行用户具有写权限。修改后先检查配置,再重启服务并验证相关变量。
十一、原文配置截图


十二、日志使用建议
- 错误日志应纳入日常监控,数据库异常时优先检查。
- 通用查询日志只在明确的短期排查期间开启。
- 慢查询日志设置合理阈值,并定期分析和归档。
- Binlog 必须配合完整备份,才能构成可靠的恢复方案。
- 监控日志目录容量,设置轮转、过期和备份策略。
- 限制日志文件权限,避免 SQL、账号信息或业务数据泄露。