聊聊 MyBatis‑Plus 深度开发规范手册的那些疑惑

先说一句，老铁们，你们在项目里用了 MyBatis‑Plus 那叫一个爽。

可别以为只会玩增删改查就完事儿，真正上生产，规矩多得跟春运的车票一样。

今天咱们就随口聊聊《MyBatis‑Plus 深度开发规范手册》里常见的几个坑，顺便抛砖引玉，帮你们把这些“隐形 Bug”给挑出来。

一、IDE 配置映射文件模板——别掉链子

在 IDEA 里搞定 mybatis 映射文件模板，那是基本功。

打开 Settings → Editor → File Templates，新建一个叫 Mapper.xml 的模板。

内容大概长这样：

记得把 ${PACKAGE_NAME}${ENTITY_NAME} 写对了不然跑起来会报 “找不到 Mapper”。

二、依赖引入——别忘了 starter

想要玩转 MyBatis‑Plus，Zui省事的办法就是直接拉 starter。

在 pom.xml 里这么写：

    com.baomidou
    mybatis-plus-boot-starter
    Zui新版本

不对不对，我刚才说的 “Zui新版本” 要自己去 Maven 中央仓库kan一下别写死成 “3.4.1”。

三、事务管理规约——防止隐形 Bug

强制： Service 里千万别自调用标了 @Transactional 的方法。

自调用 AOP 就失效，那事务根本没生效，你的回滚也白费。

还有啊，事务方法里别放网络 IO，比如调第三方支付接口或者发邮件。事务卡住不动，你的请求dou等到天黑。

四、SQL 与性Neng优化——慢查询是大忌

强制： LIKE 查询一定要右模糊（'keyword%')，左模糊会直接丢索引。

强制： 用 Lambda 写条件，这样编译期就Neng检查字段名是否写错。

# 小技巧 #

this.lambdaQuery
    .eq)
    .orderByDesc
    .list;

kan着舒服，还Neng防止拼写错误导致的空指针。

五、自动填充审计字段——省心又安全

AOP 那套东西太繁琐，用 MyBatis‑Plus 自带的 MetaObjectHandler 就行啦。

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {
    @Override
    public void insertFill {
        this.strictInsertFill);
        this.strictInsertFill);
        this.strictInsertFill;
        this.strictInsertFill;
    }
    @Override
    public void updateFill {
        this.strictUpdateFill);
    }
}

这样每次插入、geng新dou自动补齐时间戳、逻辑删除位和乐观锁版本号，省掉手动赋值的麻烦。

六、标准化基类实体——统一口径

@Data
public abstract class BaseEntity {
    /** 雪花算法 ID，防止分布式冲突 */
    @TableId
    @JsonSerialize
    private Long id;
    /** 创建时间 */
    @TableField
    private LocalDateTime createTime;
    /** geng新时间 */
    @TableField
    private LocalDateTime updateTime;
    /** 乐观锁 */
    @Version
    @TableField
    private Integer version;
    /** 逻辑删除标记 */
    @TableLogic
    @TableField
    private Integer deleted;
}

所有实体dou继承它，一行代码搞定公共字段。记得配合全局配置把逻辑删除打开：

mybatis-plus:
  global-config:
      db-config:
          logic-delete-field: deleted
          logic-delete-value: 1
          logic-not-delete-value: 0

七、插件拦截器配置——护航生产环境

@Configuration
@MapperScan
public class MybatisPlusConfig {
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor;
        // 分页插件：必须先加，否则后面的插件拿不到分页信息
        PaginationInnerInterceptor pagination = new PaginationInnerInterceptor;
        pagination.setMaxLimit; // 防止一次性拉太多数据炸内存
        interceptor.addInnerInterceptor;
        // 乐观锁插件：配合 @Version 使用
        interceptor.addInnerInterceptor);
        // 防全表geng新/删除插件：严防误操作导致数据全灭
        interceptor.addInnerInterceptor);
        return interceptor;
   }
}

八、常见坑点速查表 #1 IN 查询元素太多被卡死

强制： IN 条件Zui多传 1000 条左右，超过会导致 SQL 超长或执行慢。

#2 左模糊 LIKE 导致全表扫

用 ‘%xxx’ 完全失去索引，只Neng改成 ‘xxx%’ 或者使用全文索引来解决。

#3 乐观锁只在 updateById / update 生效！

@Version 必须跟实体一起传过去，否则插件根本不知道该怎么比较版本号。别自己硬编码 version++ 那是自闭症行为。

#4 逻辑删除字段忘记加注解

@TableLogic 没加上，删的时候真的物理删了你以后追溯不了历史数据。真是“后悔药”。

#5 分页查询总数为 0 的诡异现象

- 检查分页插件是否放在链首； - 确认没有手动关闭 countSql； - kankan是否用了自定义 SQL 丢了 count 子句。哈哈，一般dou是这几个点导致的。

九、Zui佳实践小贴士

#自动填充 + 审计日志#： 结合 AOP 在业务层记录操作者 ID，这样审计日志完整又不侵入业务代码。比如在 MetaObjectHandler 里再塞个 createBy / updateBy 字段。

#枚举统一管理#： 状态字段Zui好实现 IEnum 接口，用 EnumValue 标记存库值，这样查询时Ke以直接用枚举而不是硬编码数字。示例：

public enum StatusEnum implements IEnum{
    DISABLED,
    ACTIVE;
   @EnumValue
   private final int code;
   private final String desc;
   // getter 略...
}

#敏感字段脱敏#： 手机号之类的数据，加上 @JsonSerialize, 前端拿到自然是 *** 打码形式。别等到上线后才发现泄露呀！

十、

规范不是束缚，是给咱们保驾护航的安全网。

想想凌晨两点还得爬起来排查生产事故，那种心累真的没人愿意承受。

只要把《深度开发规范手册》里的这些硬核要求落地，就Neng让系统稳如老狗，即使业务猛涨也不慌张。

Coding 的路上，总会遇到坑，但只要大家一起踩出来分享经验，就没有翻不过的大山啦！哈哈~祝大家玩得开心，代码无 bug~你懂的~ 🚀🚀🚀

---