SpringBoot 整合 MyBatis-Plus 实现数据库 CRUD 实战

步骤 3：IDEA 中配置 Maven

打开 IDEA→'File'→'Settings'→'Build, Execution, Deployment'→'Build Tools'→'Maven'：

• Maven home path：选择解压后的 Maven 路径；
• User settings file：选择修改后的 settings.xml；
• Local repository：选择配置的本地仓库路径。

搭建 SpringBoot 项目

使用 IDEA 的 Spring Initializr 快速搭建 SpringBoot 项目，版本选择 2.7.12（推荐稳定版本）。

创建 SpringBoot 项目

步骤 1：新建项目

打开 IDEA→'New Project'→选择'Spring Initializr'→配置项目信息：

• Name：springboot-mp-demo（项目名）；
• Type：Maven Project；
• Language：Java；
• Group：com.example；
• Artifact：springboot-mp-demo；
• Java Version：8；

步骤 2：选择核心依赖

在'Dependencies'页面，勾选以下依赖（Web 开发核心）：

• Spring Web（Web 应用基础）；
• MySQL Driver（MySQL 数据库驱动）；
• Lombok（简化实体类编写）；

点击'Create'完成项目创建，IDEA 会自动下载依赖并初始化项目结构。

项目结构说明

搭建完成后的项目核心结构如下：

springboot-mp-demo
├── src/main/java/com/example/springbootmpdemo
│   ├── SpringbootMpDemoApplication.java // 项目启动类
│   ├── entity // 实体类包
│   ├── mapper // Mapper 接口包
│   └── service // 业务层包
└── src/main/resources
    ├── application.yml // 核心配置文件
    └── static/templates // 静态资源/视图层（本次暂不涉及）

整合 MyBatis-Plus

引入 MyBatis-Plus 依赖

修改 pom.xml 文件，添加 MyBatis-Plus 的核心依赖（注意版本和 SpringBoot 匹配）：

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

添加完成后，点击 IDEA 的'Reload All Maven Projects'刷新依赖。

配置数据库连接与 MyBatis-Plus

修改 src/main/resources/application.yml 文件，配置数据库连接和 MyBatis-Plus 核心参数：

# 服务器配置
server:
  port: 8080 # 项目启动端口
# 数据库配置
spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/mp_demo?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root # 你的 MySQL 用户名
    password: root # 你的 MySQL 密码
# MyBatis-Plus 配置
mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true # 开启下划线转驼峰（数据库字段 user_name→实体类 userName）
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 打印 SQL 日志（便于调试）
    mapper-locations: classpath:mapper/*.xml # Mapper XML 文件路径（本次暂不用）
    type-aliases-package: com.example.springbootmpdemo.entity # 实体类别名包

注意：需先在 MySQL 中创建数据库 mp_demo（执行 CREATE DATABASE mp_demo;），无需提前建表（后续用 MP 自动生成）。

编写实体类（Entity）

以常见的'用户表'为例，在 entity 包下创建 User.java：

package com.example.springbootmpdemo.entity;

import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
import java.time.LocalDateTime;

/**
 * 用户实体类（对应数据库 user 表）
 */
@Data // Lombok 注解，自动生成 get/set/toString 等方法
@TableName("user") // 指定数据库表名
public class User {
    /**
     * 主键 ID，自增
     */
    @TableId(type = IdType.AUTO)
    private Long id;

    /**
     * 用户名
     */
    private String userName;

    /**
     * 密码
     */
    private String password;

    /**
     * 年龄
     */
    private Integer age;

    /**
     * 创建时间
     */
    private LocalDateTime createTime;
}

说明：@Data 注解由 Lombok 提供，可省去手动编写 get/set 方法；@TableName 指定实体类对应的数据表名；@TableId 指定主键策略（AUTO 为自增）。

编写 Mapper 接口（核心：无需写 SQL）

在 mapper 包下创建 UserMapper.java，继承 MyBatis-Plus 的 BaseMapper：

package com.example.springbootmpdemo.mapper;

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

/**
 * 用户 Mapper 接口（继承 BaseMapper 即可获得 CRUD 方法）
 */
@Mapper // 标识为 MyBatis 的 Mapper 接口
public interface UserMapper extends BaseMapper<User> {
    // 无需编写任何方法，BaseMapper 已封装所有基础 CRUD 操作
}

核心亮点：继承 BaseMapper<User> 后，MP 会自动为 User 实体生成对应的 CRUD SQL，无需编写 XML 或注解 SQL，这是 MP 最核心的简化点。

启动类添加 Mapper 扫描

修改项目启动类 SpringbootMpDemoApplication.java，添加 @MapperScan 注解，扫描 Mapper 接口所在包：

package com.example.springbootmpdemo;

import org.mybatis.spring.annotation.MapperScan;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

/**
 * 项目启动类
 */
@SpringBootApplication
@MapperScan("com.example.springbootmpdemo.mapper") // 扫描 Mapper 接口包
public class SpringbootMpDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringbootMpDemoApplication.class, args);
    }
}

实战：MyBatis-Plus 实现 CRUD 操作

接下来通过 IDEA 的测试类，验证 MP 的 CRUD 功能。

创建测试类

在 src/test/java/com/example/springbootmpdemo 下，创建 UserMapperTest.java：

package com.example.springbootmpdemo;

import com.example.springbootmpdemo.entity.User;
import com.example.springbootmpdemo.mapper.UserMapper;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import java.time.LocalDateTime;
import java.util.List;

/**
 * UserMapper 测试类
 */
@SpringBootTest // 标识为 SpringBoot 测试类
public class UserMapperTest {
    // 自动注入 UserMapper
    @Autowired
    private UserMapper userMapper;

    /**
     * 测试新增用户（Create）
     */
    @Test
    public void testInsert() {
        User user = new User();
        user.setUserName("张三");
        user.setPassword("123456");
        user.setAge(20);
        user.setCreateTime(LocalDateTime.now());
        // 调用 MP 的 insert 方法，返回受影响行数
        int rows = userMapper.insert(user);
        System.out.println("新增成功，受影响行数：" + rows);
        System.out.println("新增用户的 ID：" + user.getId()); // 自增 ID 会自动回填
    }

    /**
     * 测试查询所有用户（Read）
     */
    @Test
    public void testSelectList() {
        // selectList(null) 表示查询所有数据（无条件）
        List<User> userList = userMapper.selectList(null);
        // 遍历输出
        userList.forEach(user -> System.out.println(user));
    }

    /**
     * 测试更新用户（Update）
     */
    @Test
    public void testUpdate() {
        User user = new User();
        user.setId(1L); // 要更新的用户 ID
        user.setAge(22); // 只更新年龄
        // 调用 MP 的 updateById 方法，根据 ID 更新
        int rows = userMapper.updateById(user);
        System.out.println("更新成功，受影响行数：" + rows);
    }

    /**
     * 测试删除用户（Delete）
     */
    @Test
    public void testDelete() {
        // 调用 MP 的 deleteById 方法，根据 ID 删除
        int rows = userMapper.deleteById(1L);
        System.out.println("删除成功，受影响行数：" + rows);
    }
}

运行测试并验证结果

步骤 1：运行新增测试（testInsert）

查看 MySQL 的 user 表，会新增一条用户数据，ID 自动自增。

执行 testInsert 方法，控制台会打印 MP 自动生成的 INSERT SQL：

INSERT INTO user (
    user_name, password, age, create_time
) VALUES (
    ?, ?, ?, ?
)

步骤 2：运行查询 / 更新 / 删除测试

依次执行 testSelectList、testUpdate、testDelete 方法，控制台会打印对应的 SQL 和执行结果，验证所有 CRUD 操作均可正常执行。

进阶：MyBatis-Plus 分页插件

在 Web 项目中，分页查询是高频需求，MP 提供了开箱即用的分页插件，配置和使用都非常简单。

配置分页插件

在项目中创建 config 包，新增 MyBatisPlusConfig.java：

package com.example.springbootmpdemo.config;

import com.baomidou.mybatisplus.annotation.DbType;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

/**
 * MyBatis-Plus 配置类
 */
@Configuration
public class MyBatisPlusConfig {
    /**
     * 配置分页插件
     */
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 添加 MySQL 分页插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

测试分页查询

在测试类中新增分页测试方法：

/**
 * 测试分页查询
 */
@Test
public void testPage() {
    // 构建分页条件：第 1 页，每页显示 2 条
    Page<User> page = new Page<>(1, 2);
    // 执行分页查询
    userMapper.selectPage(page, null);
    // 获取分页结果
    System.out.println("总记录数：" + page.getTotal());
    System.out.println("总页数：" + page.getPages());
    System.out.println("当前页数据：");
    page.getRecords().forEach(user -> System.out.println(user));
}

运行该方法，控制台会打印分页 SQL（包含 LIMIT），并输出分页结果，验证分页功能生效。

总结

1. SpringBoot 整合 MyBatis-Plus 的核心是引入依赖 + 配置数据库 + 继承 BaseMapper，无需编写基础 CRUD 的 SQL；
2. Lombok 的 @Data 注解可大幅简化实体类编写，MP 的 @TableName、@TableId 等注解用于关联数据库表；
3. MP 的分页插件只需简单配置，即可实现开箱即用的分页功能，提升开发效率。

在实际 Web 应用开发中，可基于本次整合的基础，进一步实现：

• 编写 Service 层封装业务逻辑；
• 编写 Controller 层提供接口，结合 Postman 测试；
• 整合 Thymeleaf 实现视图层展示用户数据；
• 添加全局异常处理、参数校验等功能，完善项目。