在 Java 后端开发中，MyBatis 是持久层事实上的标准框架，凭借其灵活的 SQL 编写能力、良好的扩展性，被绝大多数企业广泛采用。但随着业务复杂度提升，原生 MyBatis 暴露出明显痛点：大量重复的 CRUD 操作需要手写 XML 映射文件、动态 SQL 拼接依赖繁琐的 <if> 标签、主键策略与分页功能需额外集成第三方组件，这些重复劳动严重拖慢开发效率。

MyBatis-Plus（简称 MP）正是为解决这一痛点而生。它的核心定位是「只做增强，不做改变」，在 MyBatis 基础上封装了一系列实用特性，无需修改原有 MyBatis 代码，就能实现单表操作零 SQL 开发，让开发者从繁琐的样板代码中解放出来，专注于核心业务逻辑。

一、核心图谱：MyBatis-Plus 的前世今生

1. 核心关系：无损集成，效率革命

MP 与 MyBatis 的关系，用「外挂增强」来形容最为贴切，核心特点体现在两点：

• 无损集成：完全兼容 MyBatis 所有功能，你原有的 XML 配置、原生 SQL 语句、Mapper 接口无需做任何修改，二者可以完美共存，项目迁移成本为零。

• 效率革命：通过 MyBatis 的 SqlInjector 机制，在项目启动时自动注入通用 CRUD 的 SQL 语句，让单表操作彻底告别繁琐的 Mapper.xml 编写，开发效率直接翻倍。

2. 核心差异对比（清晰区分，新手秒懂）

特性	MyBatis	MyBatis-Plus
SQL 编写	每一条 CRUD 语句都需手写 XML 或注解	提供通用 CRUD 接口，零 SQL 实现单表操作
主键策略	需手动配置自增、Sequence 或自定义生成	内置多种主键生成器（雪花算法、自增、UUID 等）
条件构造	依赖 <if> 标签动态拼接，易出错、难维护	强大的 Wrapper 对象，链式编程，全代码化实现
分页功能	需集成第三方插件（如 PageHelper），配置繁琐	自带高性能分页拦截器，一行代码实现物理分页

二、实战演练：核心注解与基础构建

要发挥 MP 的最大威力，首先要掌握其核心注解 —— 通过注解实现 Java 实体类与数据库表的映射，替代原生 MyBatis 的 XML 映射配置，简单高效、易于维护。

1. 环境集成（Maven + yml，可直接复制运行）

（1）Maven 依赖

<!-- MyBatis-Plus 核心依赖（SpringBoot 版本） -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3.1</version>
</dependency>

<!-- MySQL 驱动（适配 MySQL 8.0+） -->
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>

<!-- Lombok（简化实体类，可选但推荐） -->
<dependency>
    <groupId>org.projectlombok</groupId><artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

（2）application.yml 配置

spring:
  datasource:
    # 数据库连接地址（替换为自己的数据库地址和库名）
    url: jdbc:mysql://localhost:3306/test_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false
    username: root          # 数据库用户名
    password: 123456        # 数据库密码
    driver-class-name: com.mysql.cj.jdbc.Driver

# MyBatis-Plus 核心配置
mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true  # 开启下划线转驼峰（默认开启，无需修改）
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl  # 控制台打印 SQL，方便调试
  mapper-locations: classpath:mapper/**/*.xml  # 多表关联时，XML 文件存放路径（可选）

2. 核心注解解析（实战必备，逐一说明）

MP 的注解核心作用是「映射」，无需编写 XML，即可实现实体类与数据库表、字段的关联，常用注解仅 3 个，掌握即可覆盖 90% 开发场景。

• @TableName：用于映射数据库表名。当实体类名与数据库表名不一致（如实体类 User，表名 sys_user）时，必须添加该注解指定表名；若一致（驼峰转下划线匹配），可省略。

• @TableId：用于标记实体类的主键字段，核心是配置主键生成策略。常用策略：

• IdType.AUTO：数据库自增（需确保数据库表主键设置为自增）；

• IdType.ASSIGN_ID：雪花算法（默认策略，生成全局唯一 Long 类型 ID，适合分布式项目）；

• IdType.ASSIGN_UUID：生成全局唯一 UUID 字符串（无需数据库干预）。

@TableField：用于映射普通字段，解决 3 个常见场景：

• 实体字段与表字段名不一致（如实体类 name，表字段 user_name）；

• 字段为数据库关键字（如 order、desc），需通过 value 指定别名；

• 非数据库字段（如实体类中的临时变量），通过 exist = false 排除映射；

• 敏感字段（如密码），通过 select = false 设置查询时默认不返回。

3. 完整实体类 + Mapper 代码示例（可直接复制复用）

（1）实体类 User

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import com.baomidou.mybatisplus.annotation.FieldFill; // 补全FieldFill导入（原代码缺失，避免报错）
import lombok.Data;
import java.time.LocalDateTime;

/**
 * 系统用户实体类（与数据库 sys_user 表映射）
 */
@Data // Lombok 注解，自动生成 getter/setter/toString 等方法
@TableName("sys_user") // 指定数据库表名
public class User {
    // 主键，使用雪花算法生成
    @TableId(type = IdType.ASSIGN_ID)
    private Long id;

    // 实体字段 name 与表字段 user_name 映射
    @TableField("user_name")
    private String name;

    // 实体字段与表字段一致（age → age），可省略 @TableField
    private Integer age;

    // 敏感字段，查询时默认不返回
    @TableField(select = false)
    private String password;

    // 后续自动填充演示字段（创建时间、更新时间）
    @TableField(fill = FieldFill.INSERT) // 插入时自动填充
    private LocalDateTime createTime;

    @TableField(fill = FieldFill.INSERT_UPDATE) // 插入、更新时自动填充
    private LocalDateTime updateTime;
}

（2）Mapper 接口（零代码实现基础 CRUD）

只需让 Mapper 接口继承 MP 提供的 BaseMapper<T>，即可直接调用 17+ 个内置 CRUD 方法，无需编写任何 SQL 或 XML。

import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import org.apache.ibatis.annotations.Mapper;
import com.example.demo.entity.User;

/**
 * 用户 Mapper 接口，继承 BaseMapper 获得基础 CRUD 能力
 */
@Mapper // 标记为 MyBatis Mapper 接口，SpringBoot 自动扫描
public interface UserMapper extends BaseMapper<User> {
    // 基础 CRUD 操作（insert、deleteById、update、selectList 等）无需编写代码
    // 复杂多表关联查询、自定义 SQL，可在此编写注解 SQL 或关联 XML 文件
}

（3）Service 层调用示例

实际开发中，我们通常通过 Service 层调用 Mapper，这里补充简单调用示例，让新手快速上手：

import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import org.springframework.stereotype.Service;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;

/**
 * 用户 Service 层，继承 ServiceImpl 获得更全面的 CRUD 能力
 */
@Service
public class UserService extends ServiceImpl<UserMapper, User> {
    // 无需手动注入 UserMapper，ServiceImpl 已自动注入
    // 示例：调用内置方法查询用户
    public User getUserById(Long id) {
        // 调用 BaseMapper 的 selectById 方法，零 SQL 实现
        return baseMapper.selectById(id);
    }
}

三、四大进阶武器：让开发效率翻倍

如果说基础注解是 MP 的入门钥匙，那以下四大进阶特性就是 MP 的精髓 —— 解决开发中最常见的痛点，让代码更简洁、更优雅、更易维护，也是初学者向熟手进阶的关键。

1. 灵魂组件：条件构造器（Wrapper）

痛点

原生 MyBatis 编写动态 SQL 时，需要在 XML 中写大量 <if> 标签判断参数是否为空，拼接 SQL 时容易遗漏逗号、括号，出错率高且难以维护。

方案

MP 提供的 Wrapper 条件构造器，通过链式编程实现动态 SQL 拼接，无需 XML，无需判断非空，代码优雅且不易出错。推荐使用 LambdaQueryWrapper（避免字符串拼接字段名，防止字段修改导致线上事故）。

实战代码（带执行效果）

import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    // 需求：查询年龄在 18-25 岁，且姓名包含“张”，按年龄降序排列的用户
    // 性能优化：仅查询 id、name、age 三个字段（避免全表字段扫描）
    public List<User> queryUserList() {
        // 1. 创建 LambdaQueryWrapper 对象（链式编程，类型安全）
        LambdaQueryWrapper<User> wrapper = Wrappers.lambdaQuery();
        
        // 2. 性能优化：指定查询字段，避免全表扫描（表字段较多时效果明显）
        wrapper.select(User::getId, User::getName, User::getAge)
               // 3. 拼接条件（between 范围、like 模糊查询、orderByDesc 降序）
               .between(User::getAge, 18, 25)  // 年龄 between 18 and 25
               .like(User::getName, "张")       // 姓名 like '%张%'
               .orderByDesc(User::getAge);      // 按年龄降序排列

        // 3. 调用 selectList 方法，返回结果
        List<User> users = userMapper.selectList(wrapper);
        
        // 执行效果：控制台打印 SQL（SELECT id,user_name,age FROM sys_user WHERE age BETWEEN ? AND ? AND user_name LIKE ? ORDER BY age DESC）
        // 仅查询指定3个字段，避免多余字段占用带宽，提升查询性能
        return users;
    }
}

2. 效率神器：自动分页插件（Pagination）

原理

MP 的分页插件基于 MyBatis 拦截器实现，在 SQL 执行前截获查询语句，根据数据库类型（如 MySQL、Oracle）自动添加物理分页后缀（MySQL 加 LIMIT，Oracle 加 ROWNUM），无需手动编写分页 SQL。

实战步骤（配置 + 调用，必看）

（1）分页插件配置类

注意：必须配置此拦截器，否则分页不生效！

import com.baomidou.mybatisplus.core.db.DbType;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.mybatis.spring.annotation.MapperScan;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * MyBatis-Plus 配置类
 * 分页插件、乐观锁、多租户等插件统一配置
 */
@Configuration
@MapperScan("com.example.demo.mapper")
public class MybatisPlusConfig {

    /**
     * MyBatis-Plus 拦截器（核心插件配置）
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        
        // 分页插件（MySQL数据库）
        // 注意：分页拦截器建议放在拦截器链最后
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        
        return interceptor;
    }
}

（2）分页调用示例（带分页结果说明）

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.core.toolkit.Wrappers;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

/**
 * 用户服务类
 * 提供用户相关业务逻辑
 */
@Service
public class UserService {

    @Autowired
    private UserMapper userMapper;

    /**
     * 分页查询年龄大于18的用户
     * 需求：查询第1页，每页10条数据
     *
     * @return 分页结果
     */
    public IPage<User> queryUserByPage() {
        // 1. 创建分页对象：当前页码、每页条数
        Page<User> page = new Page<>(1, 10);

        // 2. 构造查询条件：年龄 > 18
        var wrapper = Wrappers.lambdaQuery(User.class)
                .gt(User::getAge, 18);

        // 3. 执行分页查询
        IPage<User> userPage = userMapper.selectPage(page, wrapper);

        // 分页常用结果输出
        System.out.println("总记录数：" + userPage.getTotal());
        System.out.println("总页数：" + userPage.getPages());
        System.out.println("当前页数据：" + userPage.getRecords());
        System.out.println("当前页码：" + userPage.getCurrent());

        return userPage;
    }
}

3. 解放双手：自动填充（MetaObjectHandler）

痛点

几乎所有数据库表都有「创建时间（create_time）」「更新时间（update_time）」字段，每次插入、更新数据时，都需要手动设置这两个字段的值，重复劳动且容易遗漏。

方案

MP 提供自动填充功能，通过 @TableField(fill = ...) 标记需要填充的字段，再实现 MetaObjectHandler 接口，定义填充规则，即可实现插入、更新时自动赋值，一劳永逸。

实战代码（完整可运行）

import com.baomidou.mybatisplus.core.handlers.MetaObjectHandler;
import org.apache.ibatis.reflection.MetaObject;
import org.springframework.stereotype.Component;
import java.time.LocalDateTime;

/**
 * 全局公共字段自动填充处理器
 * 用于自动填充 createTime、updateTime 等公共字段
 */
@Component
public class MyMetaObjectHandler implements MetaObjectHandler {

    /**
     * 插入数据时自动填充
     */
    @Override
    public void insertFill(MetaObject metaObject) {
        // 填充创建时间
        this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now());
        
        // 填充更新时间
        this.strictInsertFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now());
    }

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

说明：实体类中已通过 @TableField(fill = FieldFill.INSERT) 和 @TableField(fill = FieldFill.INSERT_UPDATE) 标记了需要填充的字段，配置完此处理器后，插入/更新用户时，无需手动设置 createTime 和 updateTime，MP 会自动填充当前时间。

4. 数据后悔药：逻辑删除（Logic Delete）

原理

逻辑删除并非真正删除数据（不执行 DELETE 语句），而是通过更新表中的「删除标记字段」（如 deleted），将其设为 1（删除状态），查询时自动过滤删除状态的数据（WHERE deleted = 0），实现数据可恢复，避免误删导致的风险。

实战步骤（完整配置 + 用法）

（1）yml 配置（指定逻辑删除相关参数）

# MyBatis-Plus 全局配置
mybatis-plus:
  global-config:
    db-config:
      # 逻辑删除字段名（数据库字段：tinyint(1)，默认值 0）
      logic-delete-field: deleted
      # 逻辑已删除值
      logic-delete-value: 1
      # 逻辑未删除值
      logic-not-delete-value: 0

（2）实体类添加逻辑删除字段

import com.baomidou.mybatisplus.annotation.TableLogic;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;

/**
 * 用户实体类
 */
@Data
@TableName("sys_user")
public class User {

    // 其他字段省略...

    /**
     * 逻辑删除标识
     * 0：未删除
     * 1：已删除
     */
    @TableLogic
    private Integer deleted;
}

（3）使用效果（对业务代码完全透明）

// 调用 deleteById 方法，实际执行 UPDATE 语句，而非 DELETE
userMapper.deleteById(1L);
// 执行 SQL：UPDATE sys_user SET deleted = 1 WHERE id = ? AND deleted = 0

// 调用 selectList 方法，自动过滤已删除数据
List<User> users = userMapper.selectList(null);
// 执行 SQL：SELECT ... FROM sys_user WHERE deleted = 0

说明：逻辑删除后，数据仍在数据库中，若需恢复，只需将 deleted 字段改为 0 即可；若需彻底删除，可手动编写 DELETE 语句（不推荐）。

小贴士：手写 XML 原生 SQL 不会自动拼接逻辑删除条件。逻辑删除仅在使用 MP 自带的 BaseMapper 方法（如 selectList、deleteById 等）或 LambdaQueryWrapper 条件构造器时生效；若在 XML 中编写原生 SQL，需手动在 WHERE 条件中添加 AND deleted = 0，否则会查询到已逻辑删除的数据。

四、总结与最佳实践（企业级规范，必看）

MyBatis-Plus 的核心价值是「简化开发、提升效率」，但并非所有场景都适合用 MP，结合企业实际开发经验，总结以下最佳实践，避免踩坑：

1. 单表用 MP，多表用 XML

对于简单的单表 CRUD 操作，强制使用 MP 内置方法（BaseMapper、Service），避免手写 SQL；对于复杂的 3 表及以上关联查询、多条件复杂筛选，回归 XML 编写 SQL，保证 SQL 的可控性和性能。

2. 善用 Lambda，拒绝硬编码

条件构造器优先使用 LambdaQueryWrapper/LambdaUpdateWrapper，通过方法引用（User::getName）指定字段名，避免使用字符串拼接字段名（如 wrapper.like("name", "张")），防止数据库字段修改后，代码未同步修改导致的线上事故。

3. 配置性能监控，优化慢查询

开发环境下，开启 MP 自带的 SQL 打印（yml 中配置 log-impl），或集成 p6spy 插件，实时监控 SQL 执行情况，及时发现慢查询、冗余 SQL，避免线上性能问题。

4. 高频避坑指南（新手必记）

• 分页不生效？检查是否配置了 PaginationInnerInterceptor 拦截器，且指定了正确的数据库类型。

• 自动填充不生效？检查 MetaObjectHandler 类是否添加了 @Component 注解，且实体类字段的 fill 属性配置正确。

• 逻辑删除不生效？检查 yml 中逻辑删除参数配置正确，且实体类字段添加了 @TableLogic 注解。

• 字段映射失败？检查实体类注解（@TableName、@TableField）是否配置正确，或是否开启了驼峰转下划线。

最后

MyBatis-Plus 不是 MyBatis 的替代者，而是增强者。它完美兼容 MyBatis 的所有功能，同时解决了原生 MyBatis 的痛点，让开发者从繁琐的样板代码中解放出来，专注于核心业务。掌握本文的基础注解、四大进阶特性和最佳实践，即可轻松应对企业中 95% 以上的持久层开发场景，大幅提升开发效率。