mybatis插件使用 | 面试鸭返利网

MyBatis插件使用深度解析：拦截器的艺术与实践

MyBatis插件机制示意图

2025年Java面试宝典最新版
点击领取👉 链接: https://pan.baidu.com/s/1RUVf75gmDVsg8MQp4yRChg?pwd=9b3g
（提取码: 9b3g）

一、MyBatis插件机制是什么？

当面试官问"MyBatis插件使用"时，本质上在考察你对MyBatis拦截器机制的理解。简单来说，MyBatis插件就是通过动态代理技术，在四大核心对象（Executor、StatementHandler、ParameterHandler、ResultSetHandler）的方法执行前后插入自定义逻辑的钩子。

举个例子，就像在SQL执行的流水线上安装监控摄像头：

// 典型插件定义
@Intercepts({
    @Signature(type = StatementHandler.class, 
               method = "prepare", 
               args = {Connection.class, Integer.class})
})
public class MyPlugin implements Interceptor {
    // 拦截逻辑写在这里
}

二、MyBatis插件使用场景

性能监控场景

通过拦截Executor的update/query方法，可以统计SQL执行时长。某电商项目曾用此方案定位到慢查询，优化后API响应提升40%。
分页处理
拦截StatementHandler.prepare()修改原始SQL，自动追加LIMIT语句。这是最经典的MyBatis插件使用案例。
数据权限控制
在ParameterHandler阶段动态注入租户ID等参数，实现多租户数据隔离。

三、实现MyBatis插件的四步法

步骤1：实现Interceptor接口

public class SqlCostPlugin implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        long start = System.currentTimeMillis();
        Object result = invocation.proceed(); // 放行原始方法
        System.out.println("SQL执行耗时：" + (System.currentTimeMillis()-start)+"ms");
        return result;
    }
}

步骤2：声明拦截目标

通过@Signature精确指定要拦截的方法：

@Intercepts({
    @Signature(type = Executor.class, 
               method = "query",
               args = {MappedStatement.class, Object.class, RowBounds.class, ResultHandler.class})
})

步骤3：注册插件

在mybatis-config.xml中配置：

<plugins>
  <plugin interceptor="com.example.SqlCostPlugin">
    <!-- 可配置参数 -->
    <property name="threshold" value="1000"/> 
  </plugin>
</plugins>

步骤4：注意代理链顺序

重要提醒：当存在多个插件时，代理顺序是"配置倒序执行"，比如配置了A、B两个插件，实际执行顺序是：
B前置 -> A前置 -> 原始方法 -> A后置 -> B后置

四、避坑指南（面试高频考点）

代理对象穿透问题
在拦截器内部调用invocation.proceed()时，如果返回的是代理对象本身而非原始结果，会导致无限递归。解决方案：
```
Object target = MetaObject.forObject(invocation.getTarget())
                .getValue("h.target"); // 获取真实目标对象
```
线程安全陷阱
插件实现类中避免使用实例变量，因为MyBatis可能创建多个插件实例。
拦截点选择误区
不是所有方法都能拦截！只能拦截MyBatis定义的接口方法，尝试拦截私有方法会导致失效。