如何配置mysql日志环境_mysql日志调试准备

来源:这里教程网 时间:2026-02-28 20:35:26 作者:

怎么开启 MySQL 的通用查询日志(general_log)

通用查询日志记录所有到达 MySQL 服务器的 SQL 语句,适合调试连接、权限或语句执行路径问题。但它会显著降低性能,**只应在本地开发或短时排障时启用**。

开启方式分两步:

运行
SET GLOBAL general_log = ON
—— 立即生效,但重启后失效
设置日志输出目标:
SET GLOBAL log_output = 'FILE'
(默认)或
'TABLE'
(写入
mysql.general_log
表)
确认日志文件路径:
SELECT @@general_log_file
,常见为
/var/lib/mysql/hostname.log
或 Windows 下的
C:\ProgramData\MySQL\MySQL Server X.X\Data\hostname.log

若选

TABLE
方式,记得定期清理:
TRUNCATE TABLE mysql.general_log;
否则表会持续膨胀。

慢查询日志(slow_query_log)怎么配才真正有用

慢查询日志不是“只要开了就管用”。关键在

long_query_time
和是否捕获未使用索引的查询。

默认
long_query_time = 10
秒,对调试几乎无意义;建议设为
0.1
0.5
SET GLOBAL long_query_time = 0.2
务必开启
log_queries_not_using_indexes = ON
,否则漏掉大量隐性低效查询
注意:该参数仅对已打开的慢日志生效,需先
SET GLOBAL slow_query_log = ON
日志路径由
slow_query_log_file
控制,修改后需重启日志(
SET GLOBAL slow_query_log = OFF; SET GLOBAL slow_query_log = ON
)才能生效

示例配置片段(my.cnf):

[mysqld]
slow_query_log = ON
slow_query_log_file = /var/log/mysql/mysql-slow.log
long_query_time = 0.2
log_queries_not_using_indexes = ON

错误日志(error_log)位置和内容怎么看

MySQL 启动失败、崩溃、权限拒绝等关键问题都记在这里。它不记录 SQL,但记录服务级异常,是排查启动卡死、无法连接的第一站。

路径由
log_error
变量决定,执行
SELECT @@log_error
查看实际路径
常见错误如:
Can't start server: Bind on TCP/IP port: Address already in use
(端口被占)、
Plugin 'InnoDB' init function returned error
(数据文件损坏)
Linux 下若没显式配置,可能输出到
stderr
并被 systemd 截获,此时要用
journalctl -u mysql
查看
Windows 上默认写入
DATA_DIR\hostname.err
,且日志名固定带
.err
后缀,不能通过变量改扩展名

日志权限和磁盘空间容易被忽略的坑

日志本身不报错,但会导致 MySQL 拒绝写入或静默停写——尤其在容器或受限目录中。

MySQL 进程用户(如
mysql
)必须对日志目录有
wr
权限,且父目录可执行(
x
)才能进入
日志文件达到
max_relay_log_size
或磁盘满时,MySQL 不会报错,但后续日志停止写入;可用
SHOW VARIABLES LIKE '%log%size%'
查相关限制
general_log
slow_query_log
文件不会自动轮转,必须靠外部工具(如
logrotate
)或定时
FLUSH LOGS
手动切分
如果用
log_output = 'TABLE'
,注意
mysql.general_log
是 CSV 引擎(5.7 及以前),不支持事务、无索引,查大日志极慢

调试环境配完别急着写代码,先连上去跑一句

SELECT NOW()
,再立刻检查对应日志文件是否有新增行——这是验证日志链路通不通最直接的办法。

相关推荐