Agent Skills
返回列表
MyBatis-Plus 开发助手

MyBatis-Plus 开发助手

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_a36dc51e/mybatis-plus-dev

技能介绍

解决的问题

在 Java/Spring Boot 项目里，MyBatis-Plus 的难点常不在 CRUD 本身，而在依赖、配置和边界：starter 坐标随 Spring Boot 版本变化，分页需要单独引入 mybatis-plus-jsqlparser，Wrapper 不适合联表、窗口函数和复杂聚合，updateById 默认不更新 null 字段，逻辑删除、枚举映射、事务回滚和 SQL 注入防护也容易出现静默错误。

技能如何工作

它先做依赖探测：检查 pom.xml 或 build.gradle 中是否已有 mybatis-plus，再判断是完整适用、部分适用还是退出。随后按本地 references/ 路由到对应主题，如基础配置、实体映射、CRUD、分页、插件、XML 与事务。编码时强调一组硬约束：单表操作优先继承 BaseMapper / IService；条件构造优先 LambdaQueryWrapper 和方法引用；超出 Wrapper 能力的 JOIN、GROUP BY、窗口函数转 XML；分页插件放在拦截器链末尾并显式指定 DbType；外部输入进入 apply 时使用 {0} 占位符并做注入校验。

适用边界

该技能面向 MyBatis-Plus 3.5.x，3.4.x 部分兼容。纯 MyBatis 项目只适合参考 XML 和事务章节；JPA、Hibernate、DDL 设计或纯 SQL 调优不属于其范围。使用时要注意版本坐标、分页依赖、字段策略、枚举 typeHandler 和事务 rollbackFor 这些容易遗漏点。

使用场景

  • 在 Spring Boot 3 项目接入 MyBatis-Plus，配置 starter、分页插件和基础 CRUD。
  • 写条件查询和分页时，判断用 Wrapper 还是 XML，避免联表、窗口函数和 GROUP BY 硬堆条件。
  • 排查分页失效、null 字段不更新、事务未回滚或枚举字段序列化异常等问题。
  • 为 Mapper 编写 XML 联表查询和自定义分页，保证 IPage、page 入参与 ORDER BY 正确。

适合人员

  • 负责 Java/Spring Boot 后端 CRUD 的工程师，想让单表增删改查少写冗余 SQL。
  • 维护 MyBatis 项目的技术负责人，需要判断是否引入 MyBatis-Plus 并控制迁移范围。
  • 处理分页、条件查询和 XML 联表的后端开发，要避免 Wrapper 边界和 SQL 注入问题。
  • 排查 ORM 配置故障的工程师，需要快速检查 starter、分页插件、事务回滚和枚举映射。