MyBatis-Plus 拦截器迁移说明：PaginationInnerInterceptor与BlockAttackInnerInterceptor的变化

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus

在MyBatis-Plus 3.5.11版本中，开发者可能会注意到两个常用的拦截器——PaginationInnerInterceptor和BlockAttackInnerInterceptor——从核心包中消失了。这一变化引起了不少开发者的困惑，但实际上这是MyBatis-Plus团队对项目结构进行优化调整的结果。

拦截器迁移背景

MyBatis-Plus团队为了优化项目结构，提高代码的可维护性，决定将一些依赖特定解析器的功能模块进行拆分。PaginationInnerInterceptor和BlockAttackInnerInterceptor这两个拦截器都依赖于JSqlParser这个SQL解析库，因此被迁移到了专门的模块中。

新模块位置

这两个拦截器现在被移动到了mybatis-plus-jsqlparser这个独立的模块中。开发者需要在自己的项目中显式添加这个依赖才能继续使用它们。

迁移带来的影响

1. 依赖变化：项目需要新增对mybatis-plus-jsqlparser的依赖
2. 包路径变化：拦截器的完整类路径发生了变化
3. 初始化方式：虽然使用方式不变，但需要确保新模块被正确引入

解决方案

对于正在升级MyBatis-Plus版本或新创建项目的开发者，需要采取以下步骤：

1. 在项目的构建配置文件中添加新的依赖项
2. 更新拦截器的导入语句
3. 确保构建工具能够正确解析新的依赖关系

技术决策分析

这种模块化拆分带来了几个优势：

1. 减小核心包体积：让不需要这些功能的项目可以保持更精简的依赖
2. 明确功能边界：将与JSqlParser相关的功能集中管理
3. 更好的维护性：特定功能的变更不会影响核心模块的稳定性

总结

MyBatis-Plus团队通过这种模块化的调整，使得项目结构更加清晰合理。虽然短期内可能给开发者带来一些适配工作，但从长远来看，这种架构优化将提升框架的可持续发展和维护性。开发者只需按照新的模块结构调整依赖配置，即可继续使用这些强大的拦截器功能。

【免费下载链接】mybatis-plus mybatis 增强工具包，简化 CRUD 操作。 文档 http://baomidou.com 低代码组件库 http://aizuda.com 项目地址: https://gitcode.com/baomidou/mybatis-plus