MyBatis-Plus 不只是简化CRUD！资深架构师总结的15个高阶用法

大家好，我是大华！相信Java后端开发的朋友们对MyBatis-Plus（简称MP）肯定不陌生，它可以让CRUD的操作瞬间起飞。

今天就给大家分享15个使用技巧。

1. Service 和 Mapper？

IService：内置了海量现成方法，save, update, list, page 等，适用于绝大多数单表 CRUD。
BaseMapper：当需要进行复杂联表查询、或者要写自定义 SQL 时，它就是你的主战场。

// 简单查询，用 Service 的 lambdaQuery
List users = userService.lambdaQuery()
                .eq(User::getStatus, 1)
                .like(User::getName, \"张\")
                .list();

// 复杂查询，用 Mapper + XML 或注解！
// 在 UserMapper.java 中
@Select(\"SELECT u.*, d.dept_name FROM user u LEFT JOIN dept d ON u.dept_id = d.id WHERE u.id = #{userId}\")
UserVO selectUserDetail(@Param(\"userId\") Long userId);

别在 Service 里硬塞复杂 SQL，该写 XML 的时候还是不能偷懒。

2. Lambda 表达式

MP 最棒的特性之一就是 Lambda 查询，编译期就能发现字段名错误，告别运行时才发现拼错的尴尬。

// 【错误姿势】字段名是字符串，容易拼错，编译器不报错
userService.lambdaQuery().eq(\"naem\", \"张三\"); // 运行才报错，哭死！

// 【正确姿势】使用方法引用，安全又优雅
userService.lambdaQuery().eq(User::getName, \"张三\"); 
// 编译不通过，立马改正！

3. 分页查询，不只是PageHelper的替代品

MP 的分页功能非常强大，而且与自身条件构造器无缝集成。

// 创建分页参数，并指定排序
Page page = new Page(1, 20); // 查第1页，每页20条
page.addOrder(OrderItem.desc(\"create_time\")); // 按创建时间倒序

// 执行分页查询
Page userPage = userService.page(page,
        Wrappers.lambdaQuery()
                .eq(User::getDeptId, 2)
);

// 直接转换为 VO 分页对象，一步到位
Page voPage = userPage.convert(user -> {
    UserVO vo = new UserVO();
    BeanUtils.copyProperties(user, vo); // 使用 Spring 的工具类
    // 或者用 MapStruct 等更专业的工具
    return vo;
});

4. 批量操作，性能提升的关键

大批量数据插入/更新时，一条条处理会让数据库哭泣。

// 批量插入，分批提交
List hugeUserList = ... // 一个巨大的列表
userService.saveBatch(hugeUserList, 1000); // 每1000条批量提交一次

// 批量更新（自己控制事务）
@Transactional(rollbackFor = Exception.class)
public void batchUpdateStatus(List ids, Integer status) {
    List updateList = ids.stream().map(id -> {
        User user = new User();
        user.setId(id);
        user.setStatus(status);
        return user;
    }).collect(Collectors.toList());
    userService.updateBatchById(updateList);
}

5. 条件构造器，让你的逻辑更清晰

QueryWrapper和LambdaQueryWrapper可以构建非常复杂的查询逻辑。

// 复杂的 AND-OR 组合查询
List users = userService.lambdaQuery()
    .eq(User::getStatus, 1)
    .and(wrapper -> wrapper // 这是一个 AND 嵌套
        .like(User::getName, \"张\")
        .or()
        .like(User::getEmail, \"zhang\") // name LIKE \'%张%\' OR email LIKE \'%zhang%\'
    )
    .between(User::getCreateTime, startTime, endTime)
    .list();

// 【性能技巧】只查需要的字段，避免 SELECT *
List userList = userService.lambdaQuery()
    .select(User::getId, User::getName) // 只查询 ID 和 Name 字段
    .eq(User::getStatus, 1)
    .list();

6. 自动填充，告别手动 set 创建时间

像 create_time, update_time 这种字段，就别再手动 set 了。

@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    @Override
    public void insertFill(MetaObject metaObject) {
        // 插入时自动填充
        this.strictInsertFill(metaObject, \"createTime\", LocalDateTime.class, LocalDateTime.now());
        this.strictInsertFill(metaObject, \"createBy\", String.class, getCurrentUser());
    }

    @Override
    public void updateFill(MetaObject metaObject) {
        // 更新时自动填充
        this.strictUpdateFill(metaObject, \"updateTime\", LocalDateTime.class, LocalDateTime.now());
    }
}

// 实体类字段上需要加注解
public class User {
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

7. 逻辑删除，数据不是真的删除

千万别用 delete from 硬删数据了！

# 在 application.yml 中配置
mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: deleted  # 全局逻辑删除实体字段名
      logic-delete-value: 1        # 逻辑已删除值（默认为 1）
      logic-not-delete-value: 0    # 逻辑未删除值（默认为 0）

配置后，调用 userService.removeById(1)，MP 实际执行的是：
UPDATE user SET deleted = 1 WHERE id = 1 AND deleted = 0。
所有查询也会自动带上 AND deleted = 0 条件。

8. 枚举处理器，告别数据库存数字的迷惑行为

数据库存 status = 1，代码里还要猜 1 是啥意思？用枚举！

@Getter
public enum UserStatus {
    ENABLED(1, \"启用\"),
    DISABLED(0, \"禁用\");

    private final int code;
    private final String desc;

    UserStatus(int code, String desc) {
        this.code = code;
        this.desc = desc;
    }
}

// 实体类中直接使用枚举类型
public class User {
    private UserStatus status;
}

// 配置枚举处理器（Spring Boot 基本不用配了，开箱即用）

这样，数据库存的是数字 1，但代码里操作的一直是 UserStatus.ENABLED，清晰明了！

9. 多租户数据隔离，SAAS 系统必备

SAAS 应用中，不同租户的数据必须严格隔离。MP 的租户插件可以自动在每次查询时加上租户 ID。

@Configuration
public class MybatisPlusConfig {

    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        
        // 租户插件
        TenantLineInnerInterceptor tenantInterceptor = new TenantLineInnerInterceptor();
        tenantInterceptor.setTenantLineHandler(new TenantLineHandler() {
            @Override
            public Expression getTenantId() {
                // 从当前上下文中获取租户ID，比如从 JWT Token 中
                return new StringValue(TenantContext.getCurrentTenantId());
            }
            
            @Override
            public String getTenantIdColumn() {
                return \"tenant_id\"; // 数据库中的租户ID列名
            }
            
            @Override
            public boolean ignoreTable(String tableName) {
                // 忽略不需要租户隔离的表，如全局配置表
                return \"system_config\".equals(tableName);
            }
        });
        interceptor.addInnerInterceptor(tenantInterceptor);
        return interceptor;
    }
}

10. 代码生成器，效率翻倍利器

别再手撸 Entity, Mapper, Service, Controller 了！

public class CodeGenerator {
    public static void main(String[] args) {
        AutoGenerator generator = new AutoGenerator();
        
        // 数据源配置
        DataSourceConfig dataSourceConfig = new DataSourceConfig();
        dataSourceConfig.setUrl(\"jdbc:mysql://localhost:3306/test\");
        dataSourceConfig.setDriverName(\"com.mysql.cj.jdbc.Driver\");
        dataSourceConfig.setUsername(\"root\");
        dataSourceConfig.setPassword(\"123456\");
        generator.setDataSource(dataSourceConfig);
        
        // 全局配置
        GlobalConfig globalConfig = new GlobalConfig();
        globalConfig.setOutputDir(System.getProperty(\"user.dir\") + \"/src/main/java\");
        globalConfig.setAuthor(\"大华\");
        globalConfig.setOpen(false);
        globalConfig.setSwagger2(true); // 实体属性 Swagger2 注解
        generator.setGlobalConfig(globalConfig);
        
        // 包配置
        PackageConfig packageConfig = new PackageConfig();
        packageConfig.setParent(\"com.laomao.demo\");
        packageConfig.setEntity(\"domain.entity\");
        packageConfig.setMapper(\"dao.mapper\");
        packageConfig.setService(\"service\");
        packageConfig.setServiceImpl(\"service.impl\");
        generator.setPackageInfo(packageConfig);
        
        generator.execute(); // 执行生成
    }
}

运行一下，全套代码瞬间生成！

11. 自定义全局拦截器，统一处理逻辑

可以用来做数据权限控制、SQL 性能监控、字段加解密等。

@Component
@Slf4j
public class SqlLogInterceptor implements InnerInterceptor {
    
    @Override
    public void beforeQuery(Executor executor, MappedStatement ms, Object parameter, BoundSql boundSql) {
        long start = System.currentTimeMillis();
        // 将开始时间存入当前线程上下文
    }
    
    @Override
    public void afterQuery(Executor executor, MappedStatement ms, Object parameter, BoundSql boundSql, List