搞MySQL性能排查的人,迟早都会跟慢查询日志打交道。我之前排查过一个持续了一整天的接口超时问题,最后定位到是一句没走索引的UPDATE把整库拖住了。当时要是没开着慢查询日志,光靠猜,不知道要折腾多久。所以说慢查询日志是MySQL性能分析里最便宜、最值得先开的一项能力,一点不过分。
这篇不是讲理论,我直接把慢查询日志从“是什么”到“怎么开”,再到“拿到日志之后怎么做优化”这条线完整带一遍。适合刚接触MySQL优化的人,也适合已经开了慢日志但不知道怎么用的人。全文以MySQL 5.7和8.0为主,命令和配置都给你可以直接抄的版本。
1. 慢查询日志:一条SQL从“慢”到“被发现”的完整旅程
1.1 慢查询日志到底记录了什么
慢查询日志(Slow Query Log)是MySQL官方提供的、用来记录执行时间超过指定阈值的SQL语句的日志。默认阈值是10秒,也就是说一条SQL执行时间超过10秒,才会被写入慢日志文件。
这个描述看着简单,但很多人理解有偏差。我拆开说。
第一,它记录的是“执行完成”的语句。如果一条SQL因为锁等待一直卡住,还没执行完,那它暂时不会出现在慢日志里,等它执行完、超时、或者被kill掉之后,才可能被记录。这里有个容易忽略的点:一条SQL的“执行时间”是从服务器收到请求开始,到返回结果结束的整个过程,不是单纯的计算时间。所以慢日志里的Query_time实际上包含了解析、优化、执行、发送结果的全过程。
第二,它不只记录SELECT。UPDATE、DELETE、INSERT这类写操作如果很慢,同样会记录。很多人只盯着慢查询日志里的SELECT,结果把慢UPDATE漏掉了,这不对。
第三,默认情况下,它不记录没走索引的查询,除非你额外开启log_queries_not_using_indexes参数。这个参数我建议在开发环境打开,生产环境要慎重,因为一旦打开,日志量会暴涨,后面我会专门讲。
1.2 为什么每个后端和DBA都应该先看它
MySQL里能观察SQL执行情况的手段不少,比如performance_schema、sys schema、general log、慢查询日志。但慢查询日志在实际排查中的优先级非常高,原因有几个。
一是成本低。开慢日志对线上的性能影响很小,几乎可以忽略,特别是用FILE输出模式的时候。它不像general log那样记录所有SQL,不会产生海量写入,也不会明显拖慢数据库。
二是信息足够定位问题。一条慢日志记录里包含了执行时间、锁等待时间、扫描行数、返回行数、执行SQL原文。有了这些信息,你基本能判断这条SQL的问题是出在没走索引、扫描行数过大、还是锁等待太久。
三是不依赖外部工具。官方自带的mysqldumpslow就能做初步聚合,不用装额外的监控系统。很多中小团队没有性能监控平台,慢日志就是最朴素的“监控系统”。
1.3 慢日志和“死锁”“阻塞”到底是什么关系
热词里有个“慢查询 死锁 语句阻塞”,很多人会混在一起。这里先说清楚:慢查询日志记录的是“某条SQL执行得慢”,而死锁和阻塞是“SQL执行慢的两种可能原因”。
死锁本身不会直接写进慢查询日志,它是两个或多个事务互相持有对方需要的锁,导致谁也走不下去。MySQL检测到死锁后,会回滚其中一个事务,让另一个继续。这个“被牺牲”的事务,如果执行时间超过long_query_time阈值,它对应的SQL的慢日志记录里,Lock_time和Query_time通常会异常偏高。
阻塞就更直接了。事务A锁住了某一行,事务B去更新同一行,B只能等A提交或回滚。如果A一直不提交,B就一直在等锁,直到innodb_lock_wait_timeout(默认50秒)报错。这种情况下,B的SQL执行时间会超过阈值,被记进慢日志,而且Lock_time会非常显眼。
所以我的排查习惯是:先看慢日志里的Lock_time,如果Lock_time占比高,那基本可以断定问题不是SQL本身慢,而是并发锁冲突。这个思路后面第五部分会用一个完整案例展开。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 配置前必修课:慢查询日志的核心参数与版本差异
2.1 核心参数逐个拆解
配置慢查询日志之前,先把参数搞明白。下面这几个是最常用的,我按重要程度排个序。
| 参数名 | 默认值 | 作用 | 是否动态生效 |
|---|---|---|---|
| slow_query_log | OFF | 慢查询日志总开关,1或ON表示开启 | 是 |
| slow_query_log_file | 主机名-slow.log | 慢日志文件路径 | 是(需确认文件可写) |
| long_query_time | 10 | SQL执行时间超过该值才记录,单位秒,可设小数如0.1 | 是,但已建立的连接不生效 |
| log_queries_not_using_indexes | OFF | 记录所有未使用索引的SQL,即使执行很快 | 是 |
| min_examined_row_limit | 0 | 扫描行数小于该值的SQL不记录,用于过滤小查询 | 是 |
| log_throttle_queries_not_using_indexes | 0 | 每分钟最多记录多少条未使用索引的SQL,0为不限 | 是 |
| log_output | FILE | 日志输出方式:FILE(文件)、TABLE(表)、FILE,TABLE(都写) | 是 |
这里重点解释两个坑。
第一个是long_query_time。这个参数是支持小数的,所以在MySQL 5.7以上版本里,你可以设置成0.5、0.3甚至0.1,用来抓那些“不是特别慢,但积累起来很要命”的SQL。但是注意,它是按秒算的,不是毫秒。设置long_query_time=0.1表示100毫秒,不是1毫秒。
第二个是“已建立的连接不生效”。这句话很关键。你执行SET GLOBAL long_query_time=1之后,已经存在的数据库连接用的还是旧值,只有新建立的连接才用新值。所以实际生效之后,建议你重新连一下客户端再验证,否则你会看到“我改了怎么没反应”的假象。
2.2 MySQL 5.7 与 MySQL 8.0 的差异点
MySQL 8.0相对5.7,在慢日志方面有几个差异值得注意。
第一,默认值层面,两者默认都是关闭慢日志,但文件路径规则稍有不同。5.7默认写到datadir下的主机名-slow.log,8.0也一样,不过8.0的安装包多了一些sys schema的辅助视图,官方推荐通过sys.schema_unused_indexes这类表辅助定位索引问题,慢日志本身还是那套逻辑。
第二,MySQL 8.0支持SET PERSIST,可以把参数持久化到mysqld-auto.cnf文件里,重启后依然生效。MySQL 5.7只能用SET GLOBAL临时设置,然后改my.cnf,不然一重启就丢。这个差别在生产环境很重要。
第三,8.0对权限体系更严格。5.7里需要SUPER权限才能改全局变量,8.0改成了SYSTEM_VARIABLES_ADMIN权限。普通开发账号一般是改不了的,得DBA来操作。
第四,8.0里如果使用log_output=TABLE,查询mysql.slow_log表时,sql_text字段默认是utf8mb3字符集,如果SQL里有特殊字符,可能出现显示异常,5.7里也有类似问题但没这么扎眼。
2.3 只开日志不调参数,等于没开
我见过不少团队
