MySQL 8 慢查询日志查不到 SQL:digest 归并与真实语句还原

    发布时间: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。这篇就把这条链路拆开讲,给出能直接落地的还原办法。

    digest 是什么:MySQL 为什么要把 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 表动态调整,具体以实际版本行为为准。

    从 summary 反查 digest,再用 history 表还原真实语句

    排查的正确顺序是:先在汇总表里按 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 或应用侧日志一起看。

    慢日志与 digest 对不上时的几个检查点

    如果连汇总表里都找不到对应记录,按下面几点逐项排除。其一,确认慢查询日志里的那条语句是否真的在 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