生态工具对比

MyBatis 作为一个半自动化的持久层框架，其强大的插件机制催生了一批优秀的生态工具。本文将对 MyBatis 生态中的主流工具进行全面对比，帮助开发者根据项目需求做出合理的技术选型。

生态全景图

MyBatis 核心
├── 代码生成
│   ├── MyBatis Generator（官方）
│   ├── mybatis-plus-generator
│   └── MyBatisX（IDEA 插件）
├── 分页
│   ├── PageHelper
│   └── MyBatis-Plus Pagination
├── 增强框架
│   ├── MyBatis-Plus
│   ├── MyBatis-Plus-Join（MPJ）
│   └── mybatis-dynamic-sql
├── 缓存
│   ├── mybatis-redis
│   ├── mybatis-ehcache
│   └── mybatis-caffeine
└── 集成
    ├── mybatis-spring
    └── mybatis-spring-boot-starter

核心工具对比

代码生成工具

分页插件

增强框架

缓存工具

集成工具

选型建议

场景一：传统 CRUD 项目

推荐组合：MyBatis + PageHelper + MyBatis Generator

适用：以单表为主、查询条件简单的后台管理系统
优势：生态成熟、文档丰富、学习成本低

场景二：追求开发效率

推荐组合：MyBatis-Plus + MP Generator + MP 分页

适用：互联网项目、快速迭代、单表操作为主
优势：内置通用 CRUD、代码生成器一键生成全套代码

场景三：复杂多表查询

推荐组合：MyBatis 原生 + 手写 XML + PageHelper

适用：数据仓库、报表系统、多表关联复杂
优势：SQL 完全可控、性能可精确优化

场景四：多表关联 + 开发效率

推荐组合：MyBatis-Plus + Plus-Join + MP 分页

适用：中等复杂度查询、希望减少手写 SQL
优势：在 MP 基础上支持左连接、内连接等多表操作

场景五：分布式高并发

推荐组合：MyBatis-Plus + Redis 缓存 + MP 分页

适用：高并发读写、多节点部署
优势：Redis 分布式缓存 + MP 增强 CRUD

版本兼容性

工具依赖关系图

mybatis-spring-boot-starter
    └── mybatis-spring
        └── mybatis

mybatis-plus-boot-starter
    ├── mybatis-plus
    │   └── mybatis-plus-core
    │       └── mybatis
    └── mybatis-spring-boot-starter（间接依赖）

pagehelper-spring-boot-starter
    ├── pagehelper
    │   ├── jsqlparser（SQL 解析）
    │   └── mybatis（对等依赖）
    └── pagehelper-spring-boot-autoconfigure

注意：MyBatis-Plus 已内置 mybatis-spring-boot-starter 能力，无需重复引入。PageHelper 与 MP 分页同时引入时会产生拦截器冲突，需二选一。

注意事项

1. 避免重复引入：MyBatis-Plus 已包含 mybatis-spring-boot-starter，同时引入会导致 Bean 冲突
2. 分页插件互斥：PageHelper 与 MP 分页拦截器会同时生效，导致 SQL 被双重改写
3. 代码生成器冲突：MBG 与 MP Generator 可同时使用，但生成的文件名需避免覆盖
4. 缓存选型：分布式项目优先选 Redis 缓存，单节点可选 Caffeine（性能最高）
5. 版本对齐：MyBatis-Plus 3.5.x 要求 MyBatis 3.5+，Spring Boot 3.x 需选 MP 3.5.4+

要点总结

• MyBatis 生态围绕核心框架形成了代码生成、分页、增强、缓存、集成五大类工具
• 代码生成：MBG 适合精细控制，MP Generator 适合快速生成全套代码
• 分页：PageHelper 适合原生 MyBatis，MP 分页适合 MP 项目，两者不可混用
• 增强：MyBatis-Plus 是主流选择，Plus-Join 补充多表关联能力
• 缓存：Redis 适合分布式，Caffeine 适合单节点高性能，Ehcache 适合大容量本地缓存
• 集成：Spring Boot 项目直接选对应 starter，传统 Spring 项目用 mybatis-spring
• 选型核心原则：单表为主选 MP，复杂查询选原生，分布式加 Redis 缓存

存放路径：D:\git2\jwdev\articles\MYBATIS\专家\生态工具与扩展\生态工具对比.md