mysql错误日志是mysql服务运行过程中自动生成的日志文件,用于记录mysql启动、运行、停止过程中出现的错误信息、警告信息以及部分关键的运行状态提示,是数据库问题排查最基础也最常用的依据。

mysql错误日志的核心作用
错误日志主要承担三类作用:第一是记录mysql服务启动和停止过程中的所有步骤和可能出现的错误,比如配置文件错误、端口被占用等问题都会在这里体现;第二是记录运行过程中的严重错误,比如表损坏、索引异常、连接数超限等;第三是记录部分非错误的警告信息,比如弃用功能的使用提示,帮助开发者提前规避兼容性问题。
如何定位mysql错误日志的位置
不同安装方式下mysql错误日志的默认位置不同,也可以通过配置直接查看当前实例的错误日志路径:
查看当前错误日志路径
登录mysql客户端后执行如下命令即可查看:
-- 查看错误日志文件路径 SHOW VARIABLES LIKE 'log_error';
执行后会返回类似如下的结果,value字段就是当前错误日志的完整路径:
| Variable_name | Value |
|---|---|
| log_error | /var/log/mysql/error.log |
常见默认路径
- Linux系统下源码安装或apt/yum安装的mysql,默认路径通常为/var/log/mysql/error.log或者/usr/local/mysql/data/主机名.err
- Windows系统下默认路径通常在mysql安装目录的data文件夹下,文件名为主机名.err
- 如果是自定义配置,错误日志路径由my.cnf(Linux)或my.ini(Windows)中的
log_error参数指定
错误日志的常用配置参数
可以通过修改mysql配置文件调整错误日志的相关行为,常用的配置参数如下:
| 参数名 | 作用 | 示例值 |
|---|---|---|
| log_error | 指定错误日志的存储路径和文件名 | /var/log/mysql/error.log |
| log_error_verbosity | 控制错误日志的记录详细程度,1仅记录错误,2记录错误和警告,3记录错误、警告和提示信息 | 2 |
| log_timestamps | 指定错误日志中时间戳的时区,默认是UTC,可改为SYSTEM使用系统时区 | SYSTEM |
如何用错误日志排查常见问题
排查mysql启动失败问题
当执行systemctl start mysql或者service mysql start提示启动失败时,第一步就是查看错误日志。比如出现如下错误记录:
2024-05-20T08:30:12.123456Z 0 [ERROR] Can't start server: Bind on TCP/IP port: 3306. Got error: 98: Address already in use 2024-05-20T08:30:12.123567Z 0 [ERROR] Do you already have another mysqld server running on port: 3306 ?
这段日志明确提示3306端口被占用,此时可以通过netstat -tlnp | grep 3306命令找到占用端口的进程,停止对应进程或者修改mysql配置文件中的port参数更换端口即可解决。
排查表损坏问题
当查询某个表出现报错,或者mysql运行中出现异常崩溃,错误日志可能会记录表损坏的相关信息:
2024-05-20T09:15:23.456789Z 10 [ERROR] InnoDB: Page [page id: space=12, page number=37] of table `test`.`user` is marked as corrupt 2024-05-20T09:15:23.456890Z 10 [ERROR] InnoDB: Corruption of an index page was detected in table `test`.`user`, please refer to https://ipipp.com/doc/refman/8.0/en/forcing-innodb-recovery.html for more information
根据日志提示,可以确认test库的user表存在页损坏,此时可以尝试使用REPAIR TABLE test.user;命令修复,如果修复失败可以结合备份恢复数据。
排查连接异常问题
当出现连接数超限或者权限相关的连接错误时,错误日志也会有对应记录:
2024-05-20T10:20:34.567890Z 0 [ERROR] Too many connections 2024-05-20T10:21:12.678901Z 12 [ERROR] Access denied for user 'test_user'@'192.168.0.1' (using password: YES)
第一条日志提示连接数超过max_connections参数限制,需要调整参数值或者排查是否存在连接未释放的问题;第二条日志提示test_user用户从192.168.0.1连接时密码错误或者权限不足,需要核对用户密码和授权信息。
错误日志查看的注意事项
- 错误日志会持续写入,文件大小会不断增长,需要定期清理或者配置日志轮转,避免占用过多磁盘空间
- 查看日志时可以结合时间戳定位问题发生的时间点,缩小排查范围
- 对于InnoDB存储引擎的相关错误,日志中通常会有明确的提示和官方文档的参考链接,可以根据提示进一步排查
- 不要随意删除正在写入的错误日志文件,删除后需要重启mysql服务才会生成新的日志文件,可能导致部分错误记录丢失