MySQL错误日志（Error Log）

ps：如果这篇帖子对于还在找工作和找实习的你有所帮助，可以关注我，给本贴点赞、评论、收藏并订阅专栏；同时不要吝啬您的花花

一、错误日志核心定义与作用

MySQL错误日志（Error Log）是数据库运维中最核心的排障工具，默认开启且无法禁用，主要记录MySQL服务从启动、运行到关闭全生命周期中的关键信息，包括错误（Error）、警告（Warning）、提示（Note）及调试信息，是定位服务异常、排查故障根源的首要依据。

其核心作用体现在三个方面：一是快速定位服务启动失败原因（如权限不足、配置错误）；二是诊断运行中的异常（如连接失败、死锁、引擎故障）；三是追溯服务状态变化（如正常启动/关闭、配置变更生效记录），为数据库运维、故障排查和问题复盘提供完整依据。

二、错误日志基础配置与查看

2.1 查看日志路径与配置

错误日志的存储路径可通过SQL命令直接查询，无需手动查找，命令如下：

-- 查看错误日志存储路径（全局变量）
show global variables like "log_error";

查询结果中，log_error 的值即为日志路径，默认路径通常为 data/mysql/hostname.err（例如 /data/mysql/localhost.err），具体路径会因操作系统和MySQL版本略有差异。

2.1.1 自定义日志路径（永久生效）

若需修改日志存储路径，可通过编辑MySQL配置文件（my.cnf 或 my.ini）实现，步骤如下：

# 1. 编辑配置文件（Linux系统示例路径）
vim /data/mysql/conf/my.cnf

# 2. 添加/修改配置项，指定日志路径
log-error = /data/mysql/log/mysql.err

# 3. 重启MySQL服务，使配置生效
/etc/init.d/mysql.server restart

注意：Windows系统配置文件通常为my.ini，路径可在MySQL安装目录的data文件夹下，配置方式与Linux一致，仅路径格式需调整（如 log-error = D:\MySQL\log\mysql.err）。

2.2 配置日志记录级别

通过 log_error_verbosity 全局变量可控制日志记录的详细程度，满足不同排障需求，查询当前级别命令如下：

-- 查看当前日志记录级别
show global variables like "log_error_verbosity";

该参数有三个取值，对应不同的记录范围，默认级别为2：

1：仅记录错误信息（Error），日志最简洁，适合生产环境日常监控；
2：记录错误 + 警告信息（Error + Warning），默认级别，兼顾简洁性与实用性；
3：记录所有信息（Error + Warning + Note + 调试信息），适合深度排障（如复杂启动失败、死锁分析）。

修改级别可通过 set global log_error_verbosity = 3; 临时生效（重启服务后失效），若需永久生效，需在配置文件中添加对应配置项后重启服务。

2.3 日志查看常用命令

错误日志为文本格式，可通过命令行或文本编辑器直接查看，以下是运维中最常用的命令（Linux系统）：

# 1. 查看最后50行日志（定位最新错误，最常用）
tail -n 50 /data/mysql/log/mysql.err

# 2. 实时跟踪日志（监控服务运行状态，排查实时异常）
tail -f /data/mysql/log/mysql.err

# 3. 查看日志中包含"ERROR"的行（快速筛选错误信息）
grep "ERROR" /data/mysql/log/mysql.err

# 4. 查看指定时间段的日志（需日志包含时间戳）
grep "2026-03-14" /data/mysql/log/mysql.err

Windows系统可直接用记事本、Notepad++等工具打开日志文件，或通过PowerShell执行类似筛选命令。

三、错误日志核心排障场景实战

以下是MySQL运维中最常见的3类故障场景，结合错误日志排查的完整流程，所有高危操作均标注“测试环境专用”，避免生产环境误操作。

3.1 场景1：MySQL服务启动失败

启动失败是最常见故障，错误日志会精准定位原因（如权限不足、配置错误、日志文件损坏等），排查步骤如下：

# 1. 尝试启动MySQL，确认启动失败
/etc/init.d/mysql.server restart

# 2. 查看错误日志最后几行，定位原因
tail -n 30 /data/mysql/log/mysql.err

示例故障：修改redo log文件属主导致权限不足（测试环境专用）

# 模拟故障：修改ib_logfile0文件属主为root（高危操作）
chown root.root /data/mysql/data/ib_logfile0

# 启动失败后，日志显示错误信息
(ERROR) (MY-012884) (InnoDB) /data/mysql/data/ib_logfile0 can't be opened in read-write mode.

修复方法：恢复文件属主为mysql用户，重启服务即可：

chown mysql.mysql /data/mysql/data/ib_logfile0
/etc/init.d/mysql.server start

3.2 场景2：数据库连接异常

当用户无法连接MySQL时，错误日志会记录连接失败的详细原因（如密码错误、账户锁定、端口占用等），排查步骤如下：

-- 1. 先开启详细日志，确保记录连接失败信息（临时生效）
set global log_error_verbosity = 3;

-- 2. 模拟连接失败（使用错误密码登录）
mysql -utest_pass -p'wrong_pass'

查看日志获取原因：

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

日志显示：(Note) (MY-010926) (Server) Access denied for user 'test_pass'@'localhost' (using password: YES)，明确为密码错误导致连接失败。

补充：若为账户锁定，日志会提示账户锁定相关信息，可通过 ALTER USER 'test_pass'@'localhost' ACCOUNT UNLOCK; 解锁账户。

3.3 场景3：InnoDB死锁排查

InnoDB引擎出现死锁时，错误日志会完整记录死锁事务的SQL语句、锁类型及等待关系，排查步骤如下：

第一步：创建测试环境并模拟死锁（需两个会话配合）

-- 1. 创建测试表并插入数据
use test;
create table errlog_t1(id int primary key, a varchar(10)) engine=InnoDB;
insert into errlog_t1 values (1,'a'),(2,'b');

-- 2. 会话1执行操作
begin;
delete from errlog_t1 where id=1;

-- 3. 会话2执行操作
begin;
delete from errlog_t1 where id=2;

-- 4. 会话1继续执行（触发死锁）
delete from errlog_t1 where id=2;

-- 5. 会话2继续执行（触发死锁）
delete from errlog_t1 where id=1;

第二步：查看错误日志中的死锁信息：

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

日志会详细展示两个事务的 TRANSACTION 信息、锁等待关系（如 WAITING FOR THIS LOCK TO BE GRANTED），据此可定位死锁的SQL语句，优化事务执行顺序避免死锁。

四、MySQL 8.0+ 进阶功能

4.1 日志过滤（减少无用信息）

MySQL 8.0及以上版本支持通过 dragnet 组件过滤日志，可屏蔽频繁的无用信息（如频繁的连接失败日志），仅保留关键错误信息，减少日志冗余，具体配置可参考官方文档中“日志过滤组件”相关内容。

4.2 多日志 sink 配置

MySQL 8.0 采用组件化架构，支持同时启用多个日志 sink（输出目的地），例如同时将错误日志写入文件和系统日志，配置通过 log_error_services全局变量实现，默认值为 log_filter_internal; log_sink_internal，表示日志先经过内置过滤组件，再输出到内置文件 sink。

4.3 日志格式（传统格式与JSON格式）

错误日志支持两种输出格式，可根据需求配置：

传统格式：默认格式，包含时间、线程ID、日志级别、错误码、子系统及日志信息，示例：2026-03-14T21:09:00.123456Z 0 (Note) (MY-012487) (InnoDB) DDL log recovery: begin；
JSON格式：通过启用 log_sink_json 组件实现，日志以JSON对象形式输出，包含优先级、错误码、来源文件等详细字段，便于日志分析工具解析。