在 Web 应用项目中如何从零开始搭建 SpringBoot 环境并整合 MyBatis-Plus 进行数据库操作。内容包括 JDK 与 Maven 配置、SpringBoot 项目初始化、MyBatis-Plus 依赖引入及配置、实体类与 Mapper 接口编写。通过测试类演示了新增、查询、更新、删除等基础 CRUD 功能，并展示了分页插件的配置与使用。相比传统 MyBatis，该方案无需编写 SQL 即可实现高效的数据持久化，适用于中小型 Web 项目开发。
在 Web 应用项目开发中，持久层数据操作是核心环节之一。传统的 MyBatis 需要编写大量的 XML 映射文件和 SQL 语句，效率较低；而 MyBatis-Plus（简称 MP）作为 MyBatis 的增强工具，在保留 MyBatis 原有特性的基础上，实现了'无 SQL'式的 CRUD 操作，极大简化了数据库开发流程。本文将结合 Web 开发的实战场景，从开发环境配置、SpringBoot 项目搭建、MyBatis-Plus 整合到实战 CRUD，完整讲解如何快速实现 SpringBoot+MyBatis-Plus 的数据库操作。
在开始项目开发前，需先配置好核心开发环境，本次实战使用的环境版本如下（推荐使用稳定版本）：
进入 Oracle 官网（或国内镜像站）下载 JDK 1.8 安装包，根据系统选择 Windows/x64 版本，双击安装（建议安装路径：D:\Java\jdk1.8.0_381，避免中文和空格）。
右键'此电脑'→'属性'→'高级系统设置'→'环境变量'，进行如下配置：
JAVA_HOME，值为 JDK 安装路径（如 D:\Java\jdk1.8.0_381）；Path，新增：%JAVA_HOME%\bin 和 %JAVA_HOME%\jre\bin；java -version，若显示 JDK 1.8 版本信息，说明配置成功。
下载 Maven 3.8.6 压缩包，解压到指定路径（如 D:\apache-maven-3.8.6）。
修改 Maven 的 conf/settings.xml 文件：
<localRepository>D:\maven-repo</localRepository>（自定义本地仓库位置）；<mirrors>
<mirror>
<id>aliyunmaven</id>
<mirrorOf>central</mirrorOf>
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
</mirrors>
打开 IDEA→'File'→'Settings'→'Build, Execution, Deployment'→'Build Tools'→'Maven'：
settings.xml；使用 IDEA 的 Spring Initializr 快速搭建 SpringBoot 项目，版本选择 2.7.12（推荐稳定版本）。
打开 IDEA→'New Project'→选择'Spring Initializr'→配置项目信息：
springboot-mp-demo（项目名）；com.example；springboot-mp-demo；在'Dependencies'页面，勾选以下依赖（Web 开发核心）：
点击'Create'完成项目创建，IDEA 会自动下载依赖并初始化项目结构。
搭建完成后的项目核心结构如下：
springboot-mp-demo
├── src/main/java/com/example/springbootmpdemo
│ ├── SpringbootMpDemoApplication.java // 项目启动类
│ ├── entity // 实体类包
│ ├── mapper // Mapper 接口包
│ └── service // 业务层包
└── src/main/resources
├── application.yml // 核心配置文件
└── static/templates // 静态资源/视图层（本次暂不涉及）
修改 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'刷新依赖。
修改 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 包下创建 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 包下创建 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 最核心的简化点。
修改项目启动类 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);
}
}
接下来通过 IDEA 的测试类，验证 MP 的 CRUD 功能，这也是 Web 开发中最核心的实战环节。
在 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() {
List<User> userList = userMapper.selectList();
userList.forEach(user -> System.out.println(user));
}
{
();
user.setId();
user.setAge();
userMapper.updateById(user);
System.out.println( + rows);
}
{
userMapper.deleteById();
System.out.println( + rows);
}
}
user 表，会新增一条用户数据，ID 自动自增。执行 testInsert 方法，控制台会打印 MP 自动生成的 INSERT SQL：
INSERT INTO user (
user_name,
password,
age,
create_time
) VALUES (?, ?, ?, ?)
依次执行 testSelectList、testUpdate、testDelete 方法，控制台会打印对应的 SQL 和执行结果，验证所有 CRUD 操作均可正常执行。
在 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），并输出分页结果，验证分页功能生效。
@Data 注解可大幅简化实体类编写，MP 的 @TableName、@TableId 等注解用于关联数据库表；在实际 Web 应用开发中，可基于本次整合的基础，进一步实现：
本文结合 Web 应用项目开发的实战需求，从环境配置到项目搭建，再到 MyBatis-Plus 的整合与实战，完整讲解了 SpringBoot+MyBatis-Plus 的核心使用方式。相比于传统 MyBatis，MP 极大降低了持久层开发的工作量，非常适合中小型 Web 应用开发。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online