2. MySQL 慢查询日志：开启与配置 slow_query_log、long_query_time 参数详解

慢查询日志是 MySQL 性能诊断的“第一现场”。在 Go 项目中，数据库交互频繁，一条慢 SQL 可能拖垮整个接口的响应时间。本章将深入解析慢查询日志的核心参数 slow_query_log 与 long_query_time，并给出生产环境的推荐配置。

2.1 慢查询日志的作用与原理

慢查询日志记录了执行时间超过指定阈值的 SQL 语句。MySQL 在语句执行结束后，判断其实际执行时间是否大于 long_query_time（单位：秒），若超过则将该语句及其执行信息写入日志文件或系统表。

2.2 核心参数详解

2.3 开启与配置方法

2.3.1 动态开启（无需重启）

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

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

-- 设置阈值：超过 1 秒的 SQL 被记录
SET GLOBAL long_query_time = 1;

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

-- 记录慢管理语句
SET GLOBAL log_slow_admin_statements = ON;

2.3.2 持久化配置（写入 my.cnf）

[mysqld]
slow_query_log = ON
slow_query_log_file = /var/log/mysql/slow.log
long_query_time = 1
log_queries_not_using_indexes = ON
log_slow_admin_statements = ON
min_examined_row_limit = 100

2.4 生产环境推荐配置

针对 Go 项目的高并发场景，推荐以下配置组合：

• long_query_time = 0.5：对于核心接口，超过 500ms 的 SQL 就应被记录并优化。
• log_queries_not_using_indexes = ON：强制记录全表扫描的查询，避免索引缺失导致性能问题。
• min_examined_row_limit = 100：过滤掉扫描行数极少的查询，减少日志噪音。
• log_slow_admin_statements = ON：DDL 操作（如 ALTER TABLE）在数据量大时可能很慢，需要监控。

2.5 日志内容解读

一条典型的慢查询日志记录包含以下字段：

# Time: 2025-03-21T10:15:30.123456Z
# User@Host: go_app[go_app] @  [10.0.0.1]  Id: 12345
# Query_time: 2.345678  Lock_time: 0.000123  Rows_sent: 100  Rows_examined: 50000
SET timestamp=1742544930;
SELECT * FROM orders WHERE status = 'pending' ORDER BY created_at DESC;

2.6 常见问题与避坑

• 日志文件过大：建议启用日志轮转（如 logrotate）或定期清理。
• 阈值设置过低：long_query_time = 0 会记录所有 SQL，导致日志爆炸，仅用于短期调试。
• 忽略管理语句：ALTER TABLE 在数据量大时可能执行数分钟，务必开启 log_slow_admin_statements。
• 会话级覆盖：某些 ORM 框架（如 GORM）可能设置会话级 long_query_time，导致全局配置不生效，需检查应用代码。