Java MyBatis 怎么通过自定义拦截器实现 SQL 执行耗时统计监控

冬丽小哥_9272

冬丽小哥_9272

2026-08-02

636人浏览

原创

mybatis统计sql耗时最推荐拦截executor的doquery/doupdate/dobatch方法,因其覆盖完整执行流程;需实现interceptor接口,用system.nanotime()精准计时,提取mappedstatement获取sql信息,并配置开关控制与阈值告警、聚合统计及监控对接。

java mybatis 怎么通过自定义拦截器实现 sql 执行耗时统计监控

MyBatis 通过 Interceptor 接口可拦截 Executor、StatementHandler、ParameterHandler 和 ResultSetHandler 四类对象的执行过程。要统计 SQL 执行耗时,最直接有效的方式是拦截 StatementHandler 的 prepare() 方法(获取 Statement)和 query()/update() 方法(实际执行),或更推荐拦截 Executor 的 doQuery()/doUpdate()/doBatch() 等方法——因为它们包裹了完整的 SQL 执行流程(含参数设置、语句准备、执行、结果处理),且天然支持所有操作类型。

1. 编写耗时监控拦截器

实现 org.apache.ibatis.plugin.Interceptor,在 intercept() 中记录开始时间、调用目标方法、计算耗时并打印/上报:

  • 使用 System.nanoTime()(纳秒级,精度高,不受系统时间调整影响)
  • 通过 invocation.getTarget() 获取被拦截对象(如 Executor),用 invocation.getMethod() 判断是否为 doQuery 等关键方法
  • 从 invocation.getArgs() 中提取 MappedStatement,可获取 SQL ID(ms.getId())、SQL 语句(ms.getBoundSql().getSql())等上下文信息
  • 建议增加开关控制(如配置项 mybatis.monitor.enabled=true),避免线上全量打日志

2. 配置拦截器生效

在 MyBatis 配置文件(如 mybatis-config.xml)中注册拦截器:

javascript-pro
javascript-pro

专注现代 ECMAScript、异步编程、性能优化和全栈的 JavaScript 专家,适用于现代开发

下载
<plugins><plugin interceptor="com.example.MyBatisMonitorInterceptor"><property name="enabled" value="true"></property></plugin></plugins>

若使用 Spring Boot,也可通过 @Bean 方式注入 ConfigurationCustomizer 或直接向 SqlSessionFactoryBean 的 plugins 属性添加实例。

3. 增强实用性:区分慢 SQL 与聚合统计

单纯打印每条 SQL 耗时不具运维价值,建议升级为:

  • 阈值告警:例如耗时 > 500ms 记录 WARN 日志,并输出完整 SQL、参数、执行堆栈(可用 Thread.currentThread().getStackTrace())
  • 轻量聚合:用 ConcurrentHashMap 按 SQL ID 统计平均耗时、最大耗时、QPS、错误率(捕获 SQLException),定期(如每分钟)输出 Top N 慢 SQL
  • 对接监控系统:将指标导出为 Micrometer 的 Timer 或 Counter,接入 Prometheus + Grafana;或通过 Logback 的 AsyncAppender 异步推送至 ELK/Splunk

4. 注意事项与避坑点

拦截器运行在 MyBatis 核心链路中,需保证轻量、线程安全、无副作用:

  • 避免在拦截逻辑中做 I/O(如写文件、远程调用),否则会显著拖慢 SQL 执行
  • 不要修改 invocation.getArgs() 中的参数对象(除非明确需要),尤其不要替换 BoundSql 或 ParameterMapping,易引发不可预知行为
  • 注意事务上下文:Executor 拦截器在同一个事务中可能被复用,但每个 SQL 执行都是独立 invocation,无需手动管理生命周期
  • 若使用分页插件(如 PageHelper),确保你的拦截器 @Intercepts 的签名不与其冲突(如都拦截 Executor 的同名方法),可通过 signature.type() 和 signature.method() 显式限定

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java redis

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

9617

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

6762

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

5992

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1044

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

868

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1276

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

2529

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

19851

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1135

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习