当前位置:首页 > 技术 > 正文内容

MySQL 错误日志详解

访客 技术 2026年10月12日 1

MySQL 的错误日志(Error Log)是数据库管理中一种至关重要的日志,它记录了服务器启动与关闭过程中的关键信息,以及运行期间发生的各种故障、异常和需要关注的事件。

错误日志内容概览

错误日志详细记录了 mysqld 服务的启动与终止时间戳。此外,它还包含诊断性消息,如服务器在启动、关闭或运行过程中遇到的错误、警告以及其他需要特别注意的信息。例如,当 mysqld 检测到某个表需要检查或修复时,相关信息会被写入错误日志。根据配置,错误信息也可能被同步到 performance_schema.error_log 表,从而允许通过 SQL 接口查询错误日志。如果使用 mysqld_safe 启动 mysqld,mysqld_safe 会将相关消息写入错误日志,包括 mysqld 异常退出后的重启信息。

错误日志的启用与配置

错误日志在 MySQL 中默认启用,且无法被禁用。默认情况下,日志文件存储在 MySQL 的数据目录中,文件名为 mysqld.log(Linux 系统)或 hostname.err(macOS 系统)。

如需自定义日志文件名或路径,可在配置文件 (my.cnf 或 my.ini) 的 [mysqld] 部分添加以下配置:

log-error = /path/to/your/error.log

修改配置后,必须重启 MySQL 服务才能使更改生效。

查看错误日志

错误日志以纯文本文件的形式存储,可使用任意文本编辑器直接打开查阅。要确定日志文件的具体路径,可以执行以下 SQL 查询:

mysql> SHOW VARIABLES LIKE 'log_error%';

查询结果将显示 log_error 变量的值,即错误日志文件的完整路径。

关键配置参数解析

  • log_error: 指定错误日志文件的路径。
  • log_error_services: 控制错误日志的启用组件。该变量可包含一个或多个组件,以分号(或 MySQL 8.0.12 及以上版本中的逗号)分隔。服务器将按顺序处理这些组件。默认配置通常为 log_filter_internal; log_sink_internal。
  • log_error_suppression_list: 用于抑制错误日志中特定事件的记录。
  • log_error_verbosity: 控制日志记录的详细程度。
    • 值为 1: 仅记录 ERROR 级别的消息。
    • 值为 2: 记录 ERROR 和 WARNING 级别的消息。
    • 值为 3: 记录 ERROR、WARNING 和 INFORMATION 级别的消息。
    在 MySQL Group Replication (MGR) 环境中,建议将此值设置为 3,以便获取更全面的日志信息,便于问题排查。

log_timestamps 参数:控制日志时间显示

MySQL 5.7.2 版本引入了 log_timestamps 参数,用于控制错误日志等记录的显示时间戳格式。在新版本中,该参数默认设置为 UTC。这可能导致日志中的时间比本地时间(例如北京时间)晚 8 小时,给查看和分析日志带来不便。

查看当前配置:

mysql> SHOW GLOBAL VARIABLES LIKE 'log_timestamps';

修改方法:

  • MySQL 5.7:
    1. 执行 SET GLOBAL log_timestamps = 'system';
    2. 在配置文件 my.cnf 的 [mysqld] 部分添加 log_timestamps = system。
  • MySQL 8.0:
    1. 执行 SET GLOBAL log_timestamps = 'system';

为方便国内用户阅读日志,建议将 log_timestamps 设置为 system,并将其写入配置文件。MySQL 8.0 支持此参数的持久化设置。

日志刷新与删除

随着时间的推移,错误日志文件可能会变得非常庞大。为了释放磁盘空间并便于管理,可以定期删除旧的错误日志文件。由于错误日志是普通文本文件,可以直接在文件系统中删除。

执行 FLUSH LOGS 命令(或 mysqladmin flush-logs)的效果如下:

  • MySQL 5.5.7 之前的版本:FLUSH LOGS 会将当前的错误日志文件重命名为 filename.err_old,并创建一个新的日志文件。
  • MySQL 5.5.7 及之后的版本:FLUSH LOGS 仅重新打开日志文件,不会自动进行备份或创建新文件。

如果日志文件不存在,MySQL 在启动或执行 FLUSH LOGS 时会自动创建新的日志文件,其大小为 0 字节。

如果遇到无法刷新日志的情况(例如权限问题),可能需要手动创建日志文件,如:

# 示例命令,请根据实际情况调整用户和权限
    install -omysql -gmysql -m0644 /dev/null /var/log/mysqld.log

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。