说说MyBatis插件执行顺序（PageHelper 5 问题）

最新推荐文章于 2025-07-09 21:59:56 发布

冥加

最新推荐文章于 2025-07-09 21:59:56 发布

阅读量6.3k

点赞数

CC 4.0 BY-SA版权

分类专栏： MyBatis 文章标签： MyBatis interceptor PageHelper 5 MyBatis插件顺序

本文链接：https://blog.youkuaiyun.com/mingjia1987/article/details/79665002

本文探讨了MyBatis插件的执行顺序，特别是PageHelper 5版本带来的变化。通常，插件按照配置顺序拦截Executer的query方法。但在PageHelper V5中，QueryInterceptor的规范有所调整，可能会影响到原有的插件执行顺序，作者对此进行了详细说明。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

之前因为觉得spring cache的使用比较麻烦，所以弄了个简单的 MyBatisCache自动缓存插件，在测试过程中，PageHelper插件的版本变化引出了插件执行顺序的问题：
起因：PageHelper v4.x和v5.x在实现上进行了改变，PageHelper主要是拦截Executor的query方法，为select语句添加物理分页语句，问题就出在query方法上，query方法有两个：
1，<E> List<E> query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler, CacheKey cacheKey, BoundSql boundSql) throws SQLException;
2，<E> List<E> query(MappedStatement ms, Object parameter, RowBounds rowBounds, ResultHandler resultHandler) throws SQLException;

两个方法参数不一样，其中第一个方法是被第二个方法座位内部调用，所以一般mybatis的插件对于Executer的query拦截都是拦截的第二个方法，包括PageHelper在v5之前也都是这么拦截的，所以在通常情况下插件执行顺序是这样的：