一、MyBatis-Plus 核心特性解析

1.1 通用CRUD：告别重复代码

MyBatis-Plus 为所有实体类提供默认的增删改查方法，通过继承 BaseMapper<T> 接口即可获得：

• 单表操作：insert、deleteById、updateById、selectById 等基础方法。
• 批量操作：insertBatchSomeColumn、deleteBatchIds 支持高效批量处理。
• 逻辑删除：内置 @TableLogic 注解，自动处理软删除标记（如 is_deleted 字段）。

价值：开发者仅需关注复杂业务查询，基础操作通过接口调用即可完成。

1.2 条件构造器（Wrapper）：类型安全的动态查询

传统MyBatis需手动拼接SQL条件，易引发语法错误或注入风险。MyBatis-Plus 提供 QueryWrapper 和 LambdaQueryWrapper：

• 链式调用：通过 eq()、like()、between() 等方法构建查询条件。
• Lambda支持：避免硬编码字段名，利用IDE自动补全提升代码可维护性。
• 嵌套查询：支持 and()、or() 组合复杂逻辑。

示例场景：查询年龄大于25岁且姓名包含“张”的用户，传统SQL需手动拼接，而Wrapper可一键生成。

1.3 分页插件：开箱即用的物理分页

分页是高频需求，MyBatis-Plus 通过 PaginationInterceptor 实现：

1. 配置拦截器后，调用 page() 方法传入页码与每页条数。
2. 自动生成 LIMIT offset, size 语句，并返回分页对象（含总记录数、当前页数据）。

优势：无需手动计算偏移量，避免深分页性能问题。

1.4 性能分析插件：SQL执行监控

集成 PerformanceInterceptor 可记录所有执行的SQL及其耗时，辅助排查慢查询：

• 输出格式：Time: 5 ms - ID: com.example.mapper.UserMapper.selectById
• 生产环境建议通过日志框架（如Logback）控制输出级别。

---

二、MyBatisGenerator 自动生成代码全流程

2.1 配置生成规则

MyBatisGenerator 通过XML配置文件定义生成策略，核心参数包括：

• 数据库连接：URL、用户名、密码及驱动类。
• 表映射规则：指定需生成的表名（支持正则匹配）。
• 模型类配置：
  • 实体类包路径与命名规则（如下划线转驼峰）。
  • 是否生成example类（用于动态查询，但MyBatis-Plus中通常被Wrapper替代）。
• SQL映射文件：生成XML文件存放于指定目录。

最佳实践：将配置文件纳入版本控制，确保团队环境一致。

2.2 生成内容详解

运行生成器后，输出以下文件：

1. 实体类（Model）：
   • 字段与数据库列一一对应，自动处理类型转换（如 DATETIME → LocalDateTime）。
   • 可通过 @TableName 注解指定表名（若不符合默认命名规则）。
2. Mapper接口：
   • 包含基础CRUD方法（如 selectByPrimaryKey）。
   • 需手动继承 BaseMapper<T> 以启用MyBatis-Plus功能。
3. XML映射文件：
   • 定义SQL语句及结果映射，通常仅需保留复杂查询，简单操作由MyBatis-Plus接管。

2.3 生成后优化

自动生成的代码可能需调整以适应项目规范：

• 注解补充：为字段添加 @TableField(exist = false) 标记非数据库字段。
• Lombok集成：通过配置生成 @Data、@NoArgsConstructor 等注解，减少样板代码。
• XML清理：删除重复的CRUD语句，保留多表关联查询等复杂逻辑。

---

三、MyBatis-Plus 与 MyBatisGenerator 协同开发模式

3.1 分层架构设计

推荐采用标准三层架构，明确各层职责：

• Controller：接收HTTP请求，调用Service层。
• Service：业务逻辑处理，组合多个Mapper操作。
• Mapper：仅包含基础CRUD及复杂查询，不包含业务逻辑。

关键点：

• Service层通过依赖注入使用Mapper接口。
• 避免在Mapper中直接调用其他Mapper（导致事务失效）。

3.2 动态查询实现

结合Wrapper与生成器生成的Mapper，可灵活构建查询：

1. 简单查询：直接调用 selectById 或 selectList()。
2. 条件查询：
   java

   	QueryWrapper<User> wrapper = new QueryWrapper<>();
   	wrapper.eq("status", 1).like("name", "张");
   	List<User> users = userMapper.selectList(wrapper);

3. 关联查询：保留XML中的多表JOIN语句，通过 @Select 注解引用。

3.3 事务管理

在Service方法上添加 @Transactional 注解确保数据一致性：

• 传播行为：默认 REQUIRED（支持嵌套调用）。
• 隔离级别：根据业务需求选择（如 READ_COMMITTED 避免脏读）。

注意：避免在Mapper方法上声明事务，可能导致自调用失效。

3.4 自定义方法扩展

当生成器无法满足复杂需求时，可手动扩展Mapper：

1. XML中定义SQL：
   xml

   	<select id="selectByAgeRange" resultType="User">
   	SELECT * FROM user WHERE age BETWEEN #{min} AND #{max}
   	</select>

2. Mapper接口中添加方法：
   java

   List<User> selectByAgeRange(@Param("min") Integer min, @Param("max") Integer max);

---

四、性能优化与常见问题解决

4.1 SQL优化策略

• 索引利用：确保查询字段有适当索引，避免全表扫描。
• Wrapper优化：避免在循环中构建Wrapper，应批量处理。
• 分页优化：大数据量分页时，使用“上一页最大ID”替代页码（如 WHERE id > last_id LIMIT size）。

4.2 缓存配置

MyBatis-Plus 支持一级缓存（SqlSession级别）和二级缓存（Mapper级别）：

• 一级缓存：默认开启，相同SqlSession内重复查询直接返回结果。
• 二级缓存：需在Mapper XML中添加 <cache> 标签，并配置缓存实现（如PerpetualCache）。

适用场景：对数据实时性要求不高的配置类数据。

4.3 常见错误处理

1. 实体类字段与数据库列不匹配：
   • 检查 @TableField 注解是否正确配置。
   • 确认数据库列名是否符合下划线转驼峰规则。
2. 分页失效：
   • 确保已注册分页拦截器。
   • 检查是否在同一个SqlSession中执行分页查询。
3. 事务不生效：
   • 确认方法是否被Spring管理（如非private方法）。
   • 检查调用链是否涉及自调用。

---

五、进阶实践与生态工具

5.1 多数据源支持

通过动态数据源路由（如AbstractRoutingDataSource）实现：

• 根据请求参数或线程变量切换数据源。
• 适用于读写分离、分库分表场景。

5.2 代码生成器扩展

自定义生成器模板以支持：

• 生成Service层代码。
• 添加Swagger注解生成API文档。
• 集成JUnit测试用例。

5.3 与Spring Boot深度集成

Spring Boot Starter简化了配置流程：

1. 添加依赖后自动注册SqlSessionFactory、MapperScannerConfigurer等Bean。
2. 通过 application.yml 配置数据源、分页插件等参数。

---

结论：自动化持久层开发的未来趋势

MyBatis-Plus 与 MyBatisGenerator 的结合，标志着持久层开发从“手动编码”向“约定优于配置”的转变。通过自动化生成基础代码、标准化查询接口、集成性能监控，开发者可将精力聚焦于业务逻辑实现，显著提升开发效率与代码质量。

未来展望：

• 低代码平台：进一步抽象数据库操作，通过可视化界面生成代码。
• AI辅助开发：利用机器学习预测查询模式，自动优化SQL与索引。
• 跨语言支持：将MyBatis生态扩展至Go、Python等语言，满足全栈开发需求。

掌握这一组合工具后，开发工程师可轻松应对从简单CRUD到复杂数据分析的全场景需求，为构建高效、稳定的企业级应用奠定坚实基础。