《SpringBoot+MyBatis-Plus：从环境配置到 CRUD 实战，30 分钟搭好 Web 后端》

是妖气

700人浏览 · 2025-12-26 08:34:06

是妖气 · 2025-12-26 08:34:06 发布

1. JDK 安装（以 JDK1.8 为例）

下载地址：Oracle 官网 JDK1.8（选对应系统版本）
安装后配置环境变量：
- 新建JAVA_HOME：值为 JDK 安装路径（比如C:\Program Files\Java\jdk1.8.0_202）
- 编辑Path：添加%JAVA_HOME%\bin和%JAVA_HOME%\jre\bin
验证：cmd 输入java -version，显示版本号即成功（截图 1：cmd 验证 JDK 的界面）

2. Maven 配置

下载地址：Apache Maven 官网（选 Binary zip archive）
解压后配置环境变量：
- 新建MAVEN_HOME：值为 Maven 解压路径（比如D:\apache-maven-3.8.6）
- 编辑Path：添加%MAVEN_HOME%\bin

配置国内镜像（修改conf/settings.xml）：在<mirrors>标签内加阿里云镜像

xml

<mirror>
  <id>aliyunmaven</id>
  <mirrorOf>central</mirrorOf>
  <url>https://maven.aliyun.com/repository/public</url>
</mirror>

验证：cmd 输入mvn -v，显示版本号即成功（截图 2：cmd 验证 Maven 的界面）

3. IDEA 配置（2022 版）

打开 IDEA，进入File > Settings > Build, Execution, Deployment > Build Tools > Maven：
- 选择 Maven 安装路径（Maven home path）
- 选择刚才修改的settings.xml（User settings file）
- 选择本地仓库路径（可自定义，比如D:\maven-repo）（截图 3：IDEA 中 Maven 配置界面）

二、10 分钟快速搭建 SpringBoot 项目

1. 用 IDEA 创建 SpringBoot 项目

打开 IDEA，选New Project > Spring Initializr：
- 项目信息：Group 填com.example，Artifact 填springboot-mybatisplus-demo，Java 版本选 8
- 选择依赖：勾选Spring Web、MySQL Driver（截图 4：Spring Initializr 选择依赖界面）
点击 “Create”，等待 Maven 下载依赖（第一次可能慢，耐心等～）

2. 配置 application.yml（核心配置文件）

在resources目录下新建application.yml，替换默认的 application.properties：

yaml

server:
  port: 8080 # 项目启动端口

spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/test_db?useSSL=false&serverTimezone=UTC&characterEncoding=utf8
    username: root # 你的MySQL用户名
    password: 123456 # 你的MySQL密码

mybatis-plus:
  mapper-locations: classpath:mapper/*.xml # Mapper接口对应的XML文件路径
  type-aliases-package: com.example.springbootmybatisplusdemo.entity # 实体类包路径
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 打印SQL日志（方便调试）

三、整合 MyBatis-Plus（实现 CRUD 不用写 SQL）

1. 引入 MyBatis-Plus 依赖

在pom.xml中添加依赖（SpringBoot 版本对应 MyBatis-Plus 版本，这里用 3.5.2）：

xml

<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.2</version>
</dependency>

（截图 5：pom.xml 中添加 MyBatis-Plus 依赖的界面）

2. 建表 + 写实体类

先在 MySQL 的test_db库中建表：

sql

CREATE TABLE user (
  id BIGINT NOT NULL AUTO_INCREMENT COMMENT '主键ID',
  name VARCHAR(30) DEFAULT NULL COMMENT '姓名',
  age INT DEFAULT NULL COMMENT '年龄',
  email VARCHAR(50) DEFAULT NULL COMMENT '邮箱',
  PRIMARY KEY (id)
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

（截图 6：MySQL 中创建 user 表的界面）

写实体类User.java：

java

运行

package com.example.springbootmybatisplusdemo.entity;

import lombok.Data;

@Data // Lombok注解，自动生成get/set等方法
public class User {
    private Long id;
    private String name;
    private Integer age;
    private String email;
}

3. 写 Mapper 接口（继承 BaseMapper）

MyBatis-Plus 的BaseMapper已经封装了 CRUD 方法，直接继承即可：

java

运行

package com.example.springbootmybatisplusdemo.mapper;

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

@Mapper // 标记为Mapper接口，SpringBoot会自动扫描
public interface UserMapper extends BaseMapper<User> {
}

4. 写 Service+Controller（测试 CRUD）

Service 层UserService.java：

java

运行

package com.example.springbootmybatisplusdemo.service;

import com.baomidou.mybatisplus.extension.service.IService;
import com.example.springbootmybatisplusdemo.entity.User;

public interface UserService extends IService<User> {
}

UserServiceImpl.java：

java

运行

package com.example.springbootmybatisplusdemo.service.impl;

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

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
}

Controller 层UserController.java：

java

运行

package com.example.springbootmybatisplusdemo.controller;

import com.example.springbootmybatisplusdemo.entity.User;
import com.example.springbootmybatisplusdemo.service.UserService;
import org.springframework.web.bind.annotation.*;

import javax.annotation.Resource;
import java.util.List;

@RestController
@RequestMapping("/user")
public class UserController {

    @Resource
    private UserService userService;

    // 新增用户
    @PostMapping
    public boolean saveUser(@RequestBody User user) {
        return userService.save(user);
    }

    // 查询所有用户
    @GetMapping
    public List<User> listUser() {
        return userService.list();
    }

    // 根据ID查询用户
    @GetMapping("/{id}")
    public User getUserById(@PathVariable Long id) {
        return userService.getById(id);
    }

    // 修改用户
    @PutMapping
    public boolean updateUser(@RequestBody User user) {
        return userService.updateById(user);
    }

    // 删除用户
    @DeleteMapping("/{id}")
    public boolean deleteUser(@PathVariable Long id) {
        return userService.removeById(id);
    }
}

四、测试运行（Postman + 浏览器验证）

启动 SpringBoot 项目：点击 IDEA 中 Main 类的 “Run” 按钮（截图 7：IDEA 启动项目成功的日志界面）
用 Postman 测试接口：
- 新增用户：POST 请求http://localhost:8080/user，Body 传 JSON：
  json
```
{"name":"张三","age":20,"email":"zhangsan@test.com"}
```
  返回true即成功（截图 8：Postman 新增用户的请求界面）
- 查询所有用户：GET 请求http://localhost:8080/user，返回用户列表（截图 9：Postman 查询用户的响应界面）