发布时间:2026-09-30 12:31 更新时间:2026-09-30 12:31 阅读量:12
不少站长在开启 slow_query_log 后遇到过这种情形:日志里明明记着一条 SELECT,语句文本却是带问号或省略号的骨架,比如 SELECT * FROM orders WHERE user_id = ?。把这段文本原样丢进 performance_schema 去查,却一行都匹配不到,仿佛这条 SQL 从未存在过。问题通常不在日志本身,而在于 MySQL 8 默认会把语句归一化成 digest,日志和 performance_schema 里存的都是归一化结果,而不是你手写的那条原始 SQL。这篇就把这条链路拆开讲,给出能直接落地的还原办法。
MySQL 8 的 performance_schema 在记录语句时,会先对 SQL 文本做一次归一化处理,得到 digest。归一化的动作包括:把字面量常量替换成占位符、统一大小写、压缩空白与注释,最终产出一个只保留语句结构的文本,并据此算出一个 64 位哈希值,也就是 DIGEST。这样做的目的是把「同一类语句」聚合到一起统计,否则每个不同的参数值都会生成一条独立记录,性能视图会被瞬间撑爆。
归一化的副作用也很直接:你在慢查询日志里看到的 ?,在 performance_schema 里同样以 ? 出现。想用带具体参数值的那条 SQL 去 LIKE 匹配,自然搜不到。另外要注意,只有真正执行过的语句才会进入 performance_schema 的语句表,被慢查询日志记录的门槛(long_query_time)与 performance_schema 的采集开关是两套独立机制,日志里有不代表采集表里一定有,这和 performance_schema 的 consumers 是否开启有关。
先确认采集相关的开关状态,避免白忙一场:
SHOW VARIABLES LIKE 'slow_query_log';
SHOW VARIABLES LIKE 'long_query_time';
SELECT NAME, ENABLED FROM performance_schema.setup_consumers
WHERE NAME LIKE 'events_statements%';
SELECT NAME, ENABLED FROM performance_schema.setup_instruments
WHERE NAME = 'statement/sql/select';
如果 events_statements_history 或 events_statements_history_long 对应的 consumer 是 NO,那么历史表里就不会有记录,需要按官方文档说明在配置文件中开启后重启,或用 setup_consumers 表动态调整,具体以实际版本行为为准。
排查的正确顺序是:先在汇总表里按 digest 找到可疑语句的指纹,再拿指纹去历史表里捞出带真实参数的原始文本。汇总表 events_statements_summary_by_digest 会按 DIGEST 聚合,包含执行次数、总耗时、扫描行数等指标,非常适合先定位「哪类语句最慢」。
SELECT DIGEST_TEXT,
COUNT_STAR,
ROUND(SUM_TIMER_WAIT/1000000000000,2) AS total_sec,
SUM_ROWS_EXAMINED,
SUM_ROWS_SENT,
DIGEST
FROM performance_schema.events_statements_summary_by_digest
ORDER BY SUM_TIMER_WAIT DESC
LIMIT 10;
拿到 DIGEST 之后,去历史表里按这个指纹检索。历史表里既有归一化后的 DIGEST_TEXT,也有保存原始语句的 SQL_TEXT 列——这正是还原真实语句的关键。
SELECT SQL_TEXT,
DIGEST_TEXT,
CURRENT_SCHEMA,
ROWS_EXAMINED,
ROWS_SENT,
TIMER_WAIT/1000000000000 AS exec_sec
FROM performance_schema.events_statements_history
WHERE DIGEST = '你的digest值'
ORDER BY TIMER_WAIT DESC
LIMIT 20;
两个坑要提前说清楚。第一,history 表默认只保留每个线程最近若干条语句,容量有限,events_statements_history_long 保留得更久但内存占用更高,能不能查到取决于问题发生时间距离现在有多近,必要时提前调大表的行数上限。第二,如果语句是被存储过程或预处理语句(prepared statement)执行的,SQL_TEXT 里可能只看到 execute stmt 之类的内容,真实 SQL 需要结合 events_statements_prepared_statements_instances 或应用侧日志一起看。
如果连汇总表里都找不到对应记录,按下面几点逐项排除。其一,确认慢查询日志里的那条语句是否真的在 performance_schema 开启采集之后才执行,采集是运行时行为,不回溯历史。其二,注意 long_query_time 与 min_examined_row_limit 等参数只会影响日志写入,不改变采集逻辑,别把两者混为一谈。其三,检查是否开启了 performance_schema 本身,部分精简部署会关闭它,此时所有 events_statements 相关表都是空的。
SHOW VARIABLES LIKE 'performance_schema';
SHOW VARIABLES LIKE 'performance_schema_events_statements_history_size';
TRUNCATE TABLE performance_schema.events_statements_summary_by_digest;
最后一条 TRUNCATE 用于清空汇总统计,通常在排查前重置基线,让新出现的问题更容易被识别,执行前确认不影响正在进行的监控采集。若需要长期留存,可结合 sys 库中的 statement_analysis 视图,它对 digest 汇总做了更友好的排序和格式化,读起来比原生表轻松不少。
把流程串起来就是三步:慢日志给出归一化骨架,summary_by_digest 按指纹聚合出热点,events_statements_history 用 DIGEST 换回真实 SQL 文本。记住 digest 只是结构指纹,不等于原始语句,用带参数值的文本去匹配注定扑空。生产环境建议提前开启 history_long 采集并适当调大容量,同时把慢日志与 performance_schema 的采集开关都纳入日常巡检,这样下次再遇到「日志里有、查不到」时,几分钟就能定位到那条真正的 SQL。
| 📑 | 📅 |
|---|---|
| Nginx 与后端 POST 请求体丢失排查:缓冲与转发链路 | 2026-09-30 |
| nohup 与 systemd-run 后台任务取舍:SSH 断开进程被杀排查 | 2026-09-30 |
| PostgreSQL慢查询定位:pg_stat_statements安装与top SQL排序实战 | 2026-09-30 |
| Docker容器ulimit不生效排查:句柄继承链路与优先级 | 2026-09-30 |
| Nginx 与后端 HTTP/2 与 HTTP/1.1 混用排查:协议协商与日志字段 | 2026-09-30 |
| Redis连接数暴涨却无慢命令:连接泄漏定位实战 | 2026-09-30 |
| Linux磁盘满了但df与du不一致:挂载点遮蔽排查 | 2026-09-30 |
| Nginx日志499与502混合:按时间窗口对齐后端日志定位 | 2026-10-01 |
| 容器OOM Kill但宿主内存充足:cgroup统计口径与memory.max排查 | 2026-10-01 |
| PostgreSQL报too many clients但连接数没满:pgbouncer口径梳理 | 2026-10-01 |