4. 慢查询定义与标准：MySQL慢查询日志配置、GORM慢查询日志钩子、慢查询阈值设定

在微服务架构中，数据库查询的响应时间直接影响整个链路的吞吐量。慢查询（Slow Query）是指执行时间超过预设阈值的SQL语句。本章将系统讲解慢查询的判定标准、MySQL层面的日志配置，以及GORM框架中如何通过钩子实现慢查询的自动捕获与告警。

4.1 慢查询的定义与核心指标

慢查询并非一个绝对概念，而是相对于业务容忍度和系统负载的阈值设定。通常从以下三个维度衡量：

4.2 MySQL慢查询日志配置

MySQL原生提供了慢查询日志（Slow Query Log）功能，用于记录所有执行时间超过 long_query_time 的SQL语句。以下是生产环境推荐配置：

-- 开启慢查询日志
SET GLOBAL slow_query_log = ON;

-- 设置日志文件路径
SET GLOBAL slow_query_log_file = '/var/log/mysql/mysql-slow.log';

-- 设置阈值（单位：秒，支持小数）
SET GLOBAL long_query_time = 1.0;

-- 记录未使用索引的查询
SET GLOBAL log_queries_not_using_indexes = ON;

-- 记录慢管理语句（如ALTER TABLE）
SET GLOBAL log_slow_admin_statements = ON;

-- 每分钟最多记录多少条未使用索引的查询（防止日志暴增）
SET GLOBAL log_throttle_queries_not_using_indexes = 10;

4.2.1 慢查询日志分析工具

收集到的慢查询日志需要借助工具进行聚合分析，常用工具如下：

• mysqldumpslow：MySQL自带工具，按查询时间、锁定时间、扫描行数排序。
• pt-query-digest：Percona Toolkit核心工具，支持按指纹聚合、输出HTML报告。
• Bytebase / SOAR：开源SQL审核工具，可集成慢查询分析。

# 使用pt-query-digest分析慢查询日志
pt-query-digest /var/log/mysql/mysql-slow.log > slow_report.html

# 按平均执行时间降序排列前10条
pt-query-digest --limit=10 --order-by=avg_time /var/log/mysql/mysql-slow.log

4.3 GORM慢查询日志钩子

GORM v2 提供了 gorm.Logger 接口，允许开发者自定义日志记录行为。通过实现 Trace 方法，可以精确捕获每次查询的执行时间，并判断是否超过阈值。

4.3.1 自定义慢查询日志钩子

package logger

import (
    "context"
    "fmt"
    "time"

    "gorm.io/gorm/logger"
    "gorm.io/gorm/utils"
)

type SlowQueryLogger struct {
    logger.LogWriter
    SlowThreshold time.Duration
}

func (l *SlowQueryLogger) Trace(ctx context.Context, begin time.Time, fc func() (sql string, rowsAffected int64), err error) {
    elapsed := time.Since(begin)
    sql, rows := fc()

    // 判断是否超过慢查询阈值
    if elapsed > l.SlowThreshold {
        // 输出慢查询告警（可替换为日志收集、告警推送）
        fmt.Printf("[SLOW QUERY] %v | %s | %s | rows: %d\n",
            elapsed,
            utils.FileWithLineNum(),
            sql,
            rows,
        )
    }
}

4.3.2 集成到GORM配置

import (
    "gorm.io/gorm"
    "gorm.io/driver/mysql"
    "your-project/logger"
)

func InitDB() *gorm.DB {
    slowLogger := &logger.SlowQueryLogger{
        SlowThreshold: 200 * time.Millisecond, // 设置200ms为慢查询阈值
    }

    db, err := gorm.Open(mysql.Open(dsn), &gorm.Config{
        Logger: slowLogger,
    })
    if err != nil {
        panic("failed to connect database")
    }

    return db
}

4.4 慢查询阈值设定策略

阈值设定需要结合业务场景、数据量级和硬件性能。以下是一套经过生产验证的分级设定方案：

4.5 慢查询捕获流程（SVG）

下图展示了从GORM发起查询到MySQL记录慢日志的完整捕获链路：

4.6 慢查询日志格式对比

MySQL慢日志与GORM自定义日志在信息维度上存在差异，理解这些差异有助于制定更完善的监控策略：