Mysql

关注公众号 jb51net

关闭
首页 > 数据库 > Mysql > MySQL错误日志Error Log排查

MySQL错误日志Error Log从配置到故障排查的完全指南

作者：·云扬·

在MySQL数据库运维中,遇到服务启动失败、连接异常、死锁等问题时,错误日志（Error Log）绝对是你的 排障利器,它默认开启,记录着 MySQL 启动、关闭及运行过程中的错误、警告与调试信息,本文将从配置查看、核心作用、进阶功能三个维度,带你全面掌握Error Log的使用技巧

在 MySQL 数据库运维中，遇到服务启动失败、连接异常、死锁等问题时，错误日志（Error Log）绝对是你的 “排障利器”。它默认开启，记录着 MySQL 启动、关闭及运行过程中的错误、警告与调试信息，是定位问题根源的核心依据。本文将从配置查看、核心作用、进阶功能三个维度，带你全面掌握 Error Log 的使用技巧。

一、Error Log 基础配置与查看

1. 查看与配置日志路径

Error Log 的默认存储路径可通过 SQL 命令直接查询：

-- 查看错误日志存储路径

show global variables like "log_error";

默认路径通常为data/mysql/hostname.err（例如/data/mysql/localhost.err）。若需自定义存储路径，可通过修改配置文件实现永久生效：

# 编辑MySQL配置文件

vim /data/mysql/conf/my.cnf

# 添加配置项：指定日志存储路径

log-error = /data/mysql/log/mysql.err

# 重启MySQL服务使配置生效

/etc/init.d/mysql.server restart

2. 配置日志记录级别

通过log_error_verbosity参数可控制日志记录的详细程度，满足不同排障需求：

-- 查看当前日志级别

show global variables like "log_error_verbosity";

参数取值及对应含义：

3. 查看 Error Log 的实用命令

日常运维中，常用以下命令快速查看日志内容：

# 查看最后50行日志（定位最新错误）

tail -n 50 /data/mysql/log/mysql.err

# 实时跟踪日志（监控服务运行状态）

tail -f /data/mysql/log/mysql.err

二、Error Log 核心排障场景实战

场景 1：定位服务启动异常

MySQL 启动失败是常见故障，Error Log 能精准定位原因。以下为模拟故障与排查过程（仅限测试环境操作！）：

  1. 模拟启动异常：故意修改 redo log 文件属主，导致权限不足
# 修改ib_logfile0文件属主为root（高危操作，测试环境专用）

chown root.root /data/mysql/data/ib_logfile0

# 尝试启动MySQL，此时会启动失败

/etc/init.d/mysql.server restart

  1. 查看日志定位原因：
tail -f /data/mysql/log/mysql.err

日志将显示明确错误：[ERROR] [MY-012884] [InnoDB] /data/mysql/data/ib_logfile0 can't be opened in read-write mode.（文件无法以读写模式打开）

  1. 修复问题并重启：
# 恢复文件属主为mysql用户

chown mysql.mysql /data/mysql/data/ib_logfile0

# 重新启动服务，启动成功

/etc/init.d/mysql.server start

场景 2：诊断数据库连接异常

当用户无法连接 MySQL 时，Error Log 会记录连接失败细节（如密码错误、账户锁定）：

  1. 准备测试环境：创建带锁定规则的测试用户
-- 创建用户：密码错误4次后锁定3天
create user 'test_pass'@'localhost' identified by '123456' 
failed_login_attempts 4 password_lock_time 3;
-- 授予查询权限
grant select on *.* to 'test_pass'@'localhost';
-- 开启详细日志，记录连接失败信息
set global log_error_verbosity = 3;
  1. 模拟连接失败：使用错误密码登录
mysql -utest_pass -p'wrong_pass'  # 连接失败
  1. 查看日志获取原因：
tail -f /data/mysql/log/mysql.err

日志将显示：[Note] [MY-010926] [Server] Access denied for user 'test_pass'@'localhost' (using password: YES)

场景 3：记录与分析死锁信息

InnoDB 引擎出现死锁时，Error Log 会完整记录死锁事务的 SQL、锁类型及等待关系：

  1. 模拟死锁（需两个会话配合）：
use maria;

create table errlog_t1(id int primary key, a varchar(10)) engine=InnoDB;

insert into errlog_t1 values (1,'a'),(2,'b');
session1session2
begin;begin;
delete from errlog_t1 where id=1;delete from errlog_t1 where id=2;
delete from errlog_t1 where id=2;delete from errlog_t1 where id=1;
commit;commit;
  1. 查看死锁日志：
tail -n 100 /data/mysql/log/mysql.err

日志将详细展示两个事务的TRANSACTION信息及锁等待关系（如WAITING FOR THIS LOCK TO BE GRANTED）。

三、MySQL 8.0+ 进阶功能：日志过滤

MySQL 8.0 及以上版本支持通过dragnet组件过滤日志，避免无用信息刷屏（如频繁的连接失败日志）。

1. 开启日志过滤

-- 1. 加载dragnet过滤组件
INSTALL COMPONENT 'file://component_log_filter_dragnet';
-- 2. 配置日志服务：先过滤再输出
SET GLOBAL log_error_services = 'log_filter_dragnet; log_sink_internal';

2. 配置过滤规则（示例）

需求：限制信息类日志（Note）每分钟最多记录 1 条：

# 设置过滤规则：信息类日志每分钟不超过 1 条
SET GLOBAL dragnet.log_error_filter_rules = 'IF prio>=INFORMATION THEN throttle 1/60.';

prio>=INFORMATION：匹配 Note、Warning、Error 级别的日志；

throttle 1/60：每分钟最多记录 1 条符合条件的日志。

3. 验证过滤效果

短时间内多次触发信息类日志（如重复用错误密码登录）：

mysql -utest_pass -p'wrong_pass'  # 第1次：日志记录

mysql -utest_pass -p'wrong_pass'  # 第2次（1分钟内）：日志不记录

查看 Error Log，仅能看到第 1 次连接失败的记录。

4. 关闭日志过滤

-- 1. 恢复日志服务：直接输出，不经过滤
SET GLOBAL log_error_services = 'log_sink_internal';

-- 2. 卸载dragnet组件
UNINSTALL COMPONENT 'file://component_log_filter_dragnet';

-- 3. 恢复默认日志级别
set global log_error_verbosity = 2;

四、MySQL 8.0.22+ 新特性：从表中查询日志

MySQL 8.0.22 及以上版本支持将 Error Log 存储到performance_schema.error_log系统表中，可通过 SQL 直接查询，无需操作日志文件。

1. 常用查询示例

-- 查看最新10条错误日志
select * from performance_schema.error_log order by LOGGED desc limit 10;

-- 查看所有ERROR级别的日志（格式化输出）
select * from performance_schema.error_log where PRIO = 'ERROR'\G;

-- 查询指定时间范围的日志
select * from performance_schema.error_log 
where LOGGED between '2026-02-04 15:00:00' and '2026-02-04 15:05:00';

2. 注意事项

总结

MySQL Error Log 作为数据库运维的 “核心排障工具”，其价值不仅在于记录日志，更在于帮助我们快速定位启动异常、连接失败、死锁等问题。通过本文的配置指南、实战场景与进阶功能，相信你已能熟练运用 Error Log 解决日常运维中的大部分问题。

对于 MySQL 8.0 + 用户，建议尝试日志过滤与表查询功能，提升排障效率；而基础配置与核心排障场景则适用于所有版本，是必备的运维技能。如果遇到复杂问题，不妨先查看 Error Log—— 答案往往就在其中！

以上就是MySQL错误日志Error Log从配置到故障排查的完全指南的详细内容，更多关于MySQL错误日志Error Log排查的资料请关注脚本之家其它相关文章！

您可能感兴趣的文章:
阅读全文