SpringBoot + MySQL 慢查询自动捕获与优化方案

最新推荐文章于 2026-04-21 19:06:57 发布

原创

最新推荐文章于 2026-04-21 19:06:57 发布 · 477 阅读

标签

#spring boot #mysql #后端

在Java后端开发中，SpringBoot项目结合MySQL数据库是主流架构，但线上环境中，慢SQL往往是导致接口响应缓慢、服务性能瓶颈的核心原因。传统的慢SQL排查依赖手动分析日志，效率低下且易遗漏，尤其在高并发场景下，慢SQL可能引发数据库连接耗尽、服务雪崩等严重问题。

本文将详细讲解如何基于SpringBoot + MySQL实现慢查询的自动识别、详情记录，并自动推送针对性优化建议，全程提供完整可复制代码，步骤清晰，可直接落地到开发、测试及生产环境，帮助开发者高效排查、解决慢SQL问题。

适用场景：Java后端开发、SpringBoot项目优化、MySQL性能调优，适合有一定SpringBoot和MySQL基础的开发者，新手可跟随步骤逐步实现。

一、慢SQL核心认知与危害

1.1 什么是慢SQL

MySQL默认将执行时间超过1秒的SQL语句定义为慢SQL（该阈值可通过配置自定义）。常见的慢SQL场景包括：全表扫描、未加索引的查询、复杂多表JOIN、大数据量排序未优化、OFFSET过大的分页查询等。

1.2 慢SQL的核心危害

性能瓶颈：单条慢SQL会占用大量数据库连接和CPU资源，导致接口响应延迟，影响系统吞吐量；
服务风险：高并发场景下，大量慢SQL会耗尽数据库连接池，引发服务不可用，甚至导致服务雪崩；
排查低效：线上日志量大，手动筛选慢SQL耗时耗力，难以快速定位问题根源，增加运维成本。

1.3 方案核心目标

本文实现的方案核心解决3个问题：自动捕获慢SQL、完整记录慢SQL执行详情、自动生成针对性优化建议，无需手动盯日志，实现慢SQL的“早发现、早定位、早优化”。

二、技术选型与环境准备

2.1 技术选型

核心技术栈（轻量无额外中间件，易落地）：

SpringBoot 2.7.x（稳定版，适配大多数生产环境）；
MySQL 8.0（主流版本，支持慢查询日志配置）；
MyBatis-Plus 3.5.3.1（简化CRUD操作，无需编写XML映射文件）；
Spring AOP（核心切面，拦截SQL执行，计算执行时间）；
FastJSON2（JSON序列化，用于日志写入）；
Lombok（简化实体类编写，减少冗余代码）。

2.2 环境准备

1. 开发环境：JDK 1.8+、Maven 3.6+、IDEA；

2. 数据库环境：MySQL 8.0，开启慢查询日志（下文详细配置）；

3. 项目初始化：通过Spring Initializr创建SpringBoot项目，引入上述核心依赖。

三、实战落地：慢查询自动捕获完整实现

以下步骤从环境配置到代码实现，全程提供可复制代码，按步骤执行即可完成功能开发，所有代码均经过实测可正常运行。

3.1 第一步：MySQL慢查询日志配置

首先开启MySQL的慢查询日志，让MySQL自动记录执行耗时超过阈值的SQL语句，提供两种配置方式，根据实际场景选择。

1. 临时配置（重启MySQL后失效，适合测试环境）

-- 开启慢查询日志 set global slow_query_log = 'ON'; -- 设置慢查询阈值（单位：秒，此处设1秒，可根据业务调整） set global long_query_time = 1; -- 设置慢查询日志存储路径（自定义，确保MySQL有读写权限） set global slow_query_log_file = '/var/lib/mysql/mysql-slow.log';

2. 永久配置（修改MySQL配置文件，重启生效，适合生产环境）

找到MySQL配置文件my.cnf（Linux）或my.ini（Windows），添加如下配置：

# 开启慢查询日志 slow_query_log = ON # 慢查询阈值（单位：秒，建议生产环境根据业务调整，如0.5秒） long_query_time = 1 # 慢查询日志存储路径 slow_query_log_file = /var/lib/mysql/mysql-slow.log # 记录未使用索引的查询（建议开启，便于排查无索引导致的慢SQL） log_queries_not_using_indexes = ON

配置完成后，重启MySQL服务，执行一条全表扫描SQL（如SELECT * FROM t_user），可在指定日志路径下查看慢查询记录，验证配置是否生效。

3.2 第二步：项目依赖配置（pom.xml）

引入核心依赖，无多余冗余依赖，保证项目轻量，直接复制替换pom.xml中的依赖部分即可：

<parent> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-parent</artifactId> <version>2.7.10</version> <relativePath/> </parent> <dependencies>  <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> </dependency>  <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.1</version> </dependency>  <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <scope>runtime</scope> </dependency>  <dependency> <groupId>org.projectlombok</groupId> <artifactId>lombok</artifactId> <optional>true</optional> </dependency>  <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-aop</artifactId> </dependency>  <dep