SpringBoot 集成 MyBatis 与 MyBatis-Plus 详解

运行效果：此处无法看到输出执行的 SQL，并且会输出其他日志信息，可以在 application.properties 中配置日志输出：

logging.level.root=warn
logging.level.com.example.mapper=trace
logging.pattern.console=%p%m%n

至此，SpringBoot 和 MyBatis 集成就完成了。

SpringBoot 集成 MyBatis-Plus

MyBatis-Plus 简介

MyBatis-Plus（简称 MP）是基于 MyBatis 的增强工具，在保留 MyBatis 原有功能的基础上，实现了'无 SQL'CRUD、分页、逻辑删除、乐观锁等功能，大幅提升开发效率。

什么是 MyBatis-Plus？

MyBatis-Plus 核心理念是'只做增强，不做改变'，它封装了基础 CRUD 操作，无需编写 SQL 即可实现数据访问，同时支持自定义 SQL 扩展，完美兼容 MyBatis 原有代码。

核心优势

• 内置通用 Mapper/Service，无需编写基础 CRUD SQL；
• 支持自动分页、逻辑删除、乐观锁、枚举映射等高频功能；
• 强大的条件构造器（QueryWrapper），灵活拼接复杂 SQL；
• 支持主键自动生成（雪花算法、自增等）；
• 无缝兼容 MyBatis 配置和代码。

Lombok 简介

Lombok 是一款 Java 开发插件，通过注解（如 @Data、@NoArgsConstructor）自动生成 getter/setter/构造器/toString 等代码，核心优势：

• 简化实体类代码，减少冗余；
• 提高开发效率，避免手动维护 getter/setter；
• 支持链式编程（@Accessors(chain = true)）。

导入依赖

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>

使用示例

// 链式调用（可选）
@Accessors(chain = true)
// 核心简化：getter/setter/toString/equals/hashCode + 无参构造
@Data
// 补充全参构造（@Data 不含全参）
@AllArgsConstructor
// 补充无参构造（若@Data 的@RequiredArgsConstructor 覆盖了无参，需显式声明）
@NoArgsConstructor
public class User {
    private Long id;
    private String username;
    // 排除 toString 输出
    @ToString.Exclude
    private String password;
    private Integer age;
}

MyBatis-Plus 快速上手

启动类

添加配置

spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/ktsms_db?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
spring.datasource.username=root
spring.datasource.password=root
logging.level.root=warn
logging.level.com.example.mapper=trace
logging.pattern.console=%p%m%n

替换依赖

将 MyBatis Starter 替换为 MyBatis-Plus Starter（无需额外引入 MyBatis 依赖）：

<!-- MyBatis-Plus SpringBoot 集成包 -->
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3.1</version>
</dependency>

在启动类中添加 Mapper 包的扫描，和之前 MyBatis 一样的操作。

编码

• @TableName 注解在类上，指定数据库表名 (实体名与表名不一致时需要指定)
• @TableId(type = IdType.AUTO) 注解在主键属性上，且指定主键生成策略为自动增长
• @TableField 注解在属性上，指定数据库字段名 (不满足默认匹配规则时需要指定)。属性和字段名默认匹配规则是全小写的属性对应同名的字段：采用骆驼命名规则的属性对应的字段名为两个单词之间使用_下划线连接，例如：usrName 属性默认对应的字段名为 usr_name。

编写 Mapper 接口：

public interface SysRoleMapper extends BaseMapper<SysRole> { }

编写实体类 SysRole：

@Data
@NoArgsConstructor
@AllArgsConstructor
// 表名
@TableName("sys_role")
public class SysRole {
    // 主键 ID, 自增
    @TableId(type = IdType.AUTO)
    private Long id;
    //主键 ID
    private String code; //角色编码
    private String roleName; //角色名称
    private Long createdUserId; //创建者
    private Date createdTime; //创建时间
    private Long updatedUserId; //修改者
    private Date updatedTime; //修改时间
}

创建 SysRoleMapperTester.java：

@SpringBootTest
public class SysRoleMapperTest {
    @Autowired
    private SysRoleMapper sysRoleMapper;
    
    @Test
    public void testSelectAll() {
        List<SysRole> sysRoles = sysRoleMapper.selectList(null);
        for (SysRole sysRole : sysRoles) {
            System.out.println(sysRole);
        }
    }
}

至此，SpringBoot 集成 MyBatis-Plus 完成，通过以上几个步骤我们就实现了 sysRole 查询所有数据的功能，基本的 CRUD 都能完成，几乎不用写 SQL 语句。

常用注解

MyBatis Plus 如何知道我们要查询的是哪张表？表中有哪些字段呢？

MyBatis Plus 就是根据 PO 实体的信息来推断出表的信息，从而生成 SQL 的。默认情况下：

• MyBatis Plus 会把 PO 实体的类名驼峰转下划线作为表名
• MyBatis Plus 会把 PO 实体的所有变量名驼峰转下划线作为表的字段名，并根据变量类型推断字段类型
• MyBatis Plus 会把名为 id 的字段作为主键

但很多情况下，默认的实现与实际场景不符，因此 MyBatis Plus 提供了一些注解便于我们声明表信息。

@TableName

全类名：com.baomidou.mybatisplus.annotation.TableName

核心作用

指定实体类对应的数据库表名（解决实体类名与表名不一致的问题）。

常用属性

@TableId

全类名：com.baomidou.mybatisplus.annotation.TableId

核心作用

标记实体类的主键字段，指定主键生成策略。

常用属性

IdType 枚举值说明

@TableField

全类名：com.baomidou.mybatisplus.annotation.TableField

核心作用

指定实体属性与数据库表字段的映射关系，支持排除字段、字段填充、忽略字段等功能。

常用属性

核心功能

从以上步骤中，我们可以看到集成 MyBatis-Plus 非常的简单，只需要引入 starter 启动器，并配置 mapper 扫描路径即可。 但 MyBatis-Plus 的强大远不止这些功能，想要详细了解 MyBatis-Plus 的强大功能？那就继续往下看吧！

CRUD 接口

MyBatis 通用的 CRUD 功能都在 BaseMapper<T> 接口中：

• BaseMapper 接口封装通用 CRUD，为 Mybatis-Plus 启动时自动解析实体表关系映射转换为 Mybatis 内部对象注入容器
• 参数 Serializable 为任意类型主键，Mybatis-Plus 不推荐使用复合主键，约定每一张表都有自己的唯一 id 主键
• 泛型 T 为任意实体对象
• 对象 Wrapper 为条件构造器

条件构造器

条件构造器（Wrapper）是 MyBatis-Plus 实现动态 SQL 的核心，通过链式调用拼接 WHERE 条件，无需手动拼接 SQL 字符串，支持查询、更新、删除操作。

核心构造器类型

常用条件方法

使用示例

1. QueryWrapper（基础查询）

QueryWrapper<User> wrapper = new QueryWrapper<User>()
    .eq("user_name", "张三")
    .gt("age", 18)
    .like("email", "qq.com");
List<User> list = userMapper.selectList(wrapper);

2. UpdateWrapper（更新操作）

UpdateWrapper<User> wrapper = new UpdateWrapper<User>()
    .eq("user_name", "张三")
    .set("age", 22)
    .setSql("age = age + 1"); // 支持 SQL 片段
userMapper.update(null, wrapper);

3. LambdaQueryWrapper（类型安全查询）

LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<User>()
    .eq(User::getUserName, "张三")
    .gt(User::getAge, 18);
List<User> list = userMapper.selectList(wrapper);

注意事项

1. Lambda 版构造器通过实体类方法引用字段（如 User::getAge），避免字段名硬编码错误；
2. UpdateWrapper 可直接通过 set/setSql 设置更新字段，无需创建实体类；
3. 条件默认以 AND 拼接，需 OR 时调用 .or() 方法即可。