Spring?Boot?3.0?+?MyBatis-Plus全家桶實戰(zhàn)詳細代碼
更新時間：2025年10月29日 11:50:13 作者：云起川南
MyBatis-Plus是一個MyBatis的增強工具,是國內人員開發(fā)的MyBatis增強工具,在MyBatis的基礎上只做增強不做改變,為簡化開發(fā)、提高效率而生,這篇文章主要介紹了Spring?Boot?3.0?+?MyBatis-Plus全家桶的相關資料,需要的朋友可以參考下
概要
從依賴、配置、實體/Mapper、分頁、常用插件（邏輯刪除、樂觀鎖）、以及簡單的示例接口講起。代碼可直接復制到項目里跑通。文中引用 MyBatis-Plus 官方與社區(qū)資料以保證兼容性與最佳實踐。
1. 項目說明與目標
目標：在 Spring Boot 3.0 項目中集成 MyBatis-Plus，實現標準的增刪改查、分頁與常見插件（邏輯刪除、樂觀鎖），并演示一個可運行的示例接口供快速上手。MyBatis-Plus 官方提供 Spring Boot 3 的 starter，且社區(qū)維護活躍
2. 快速依賴（Maven）
pom.xml 關鍵依賴（只展示最重要的部分）：
<properties>
<java.version>17</java.version>
<spring-boot.version>3.0.8</spring-boot.version> <!-- 任選 Spring Boot 3.0.x -->
<mybatis-plus.version>3.5.12</mybatis-plus.version> <!-- 官方 Maven 中央庫示例版本 -->
</properties>
<dependencies>
<!-- Spring Boot Starter Web -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- Spring Boot Starter JDBC / DataSource -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-jdbc</artifactId>
</dependency>
<!-- MyBatis-Plus Spring Boot 3 starter -->
<dependency>
<groupId>com.baomidou</groupId>
<artifactId>mybatis-plus-spring-boot3-starter</artifactId>
<version>${mybatis-plus.version}</version>
</dependency>
<!-- 數據庫驅動（示例用 MySQL） -->
<dependency>
<groupId>com.mysql</groupId>
<artifactId>mysql-connector-j</artifactId>
<scope>runtime</scope>
</dependency>
<!-- 可選：Lombok (簡化實體) -->
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<optional>true</optional>
</dependency>
<!-- 測試 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-test</artifactId>
<scope>test</scope>
</dependency>
</dependencies>
注：使用 mybatis-plus-spring-boot3-starter 是推薦方式，官方/中央倉庫有發(fā)布包可用。
3. 配置文件 application.yml
示例（MySQL）：
spring:
datasource:
url: jdbc:mysql://localhost:3306/demo?useUnicode=true&characterEncoding=utf8&serverTimezone=UTC
username: root
password: root
driver-class-name: com.mysql.cj.jdbc.Driver
mybatis-plus:
configuration:
# 駝峰映射：數據庫 user_name -> Java userName
map-underscore-to-camel-case: true
global-config:
db-config:
logic-delete-field: deleted # 邏輯刪除字段名（可選）
logic-delete-value: 1
logic-not-delete-value: 0
# mapper xml 路徑（若使用 xml）
mapper-locations: classpath:/mapper/**/*.xml
type-aliases-package: com.example.demo.entity
解釋：
- map-underscore-to-camel-case：開啟下劃線->駝峰映射；
- mapper-locations：若使用 XML 映射文件需要設置路徑；
- global-config.db-config.logic-delete-field：配置邏輯刪除字段（如果你使用邏輯刪除插件/注解）。
4. 實體、Mapper、Mapper XML（或注解）
4.1 數據庫表（示例）
CREATE TABLE user ( id BIGINT AUTO_INCREMENT PRIMARY KEY, username VARCHAR(100), email VARCHAR(200), age INT, version INT DEFAULT 0, deleted TINYINT DEFAULT 0, created_at DATETIME DEFAULT CURRENT_TIMESTAMP, updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP );
4.2 實體類 User.java
package com.example.demo.entity;
import com.baomidou.mybatisplus.annotation.*;
import lombok.Data;
import java.time.LocalDateTime;
@Data
@TableName("user")
public class User {
@TableId(type = IdType.AUTO)
private Long id;
private String username;
private String email;
private Integer age;
@Version
private Integer version; // 樂觀鎖字段，@Version 標注
@TableLogic
private Integer deleted; // 邏輯刪除，0 未刪除，1 已刪除
@TableField(fill = FieldFill.INSERT)
private LocalDateTime createdAt;
@TableField(fill = FieldFill.INSERT_UPDATE)
private LocalDateTime updatedAt;
}說明：
- @TableId：主鍵策略；
- @Version：開啟樂觀鎖支持（需配合插件）；
- @TableLogic：邏輯刪除字段（MyBatis-Plus 會在 DELETE 時改寫成更新已刪除標志）。
4.3 Mapper 接口 UserMapper.java
package com.example.demo.mapper;
import com.baomidou.mybatisplus.core.mapper.BaseMapper;
import com.example.demo.entity.User;
import org.apache.ibatis.annotations.Mapper;
@Mapper
public interface UserMapper extends BaseMapper<User> {
// BaseMapper 已經包含常見 CRUD 方法（insert, deleteById, updateById, selectById, selectList...）
// 可擴展自定義方法
}MyBatis-Plus 提供 BaseMapper<T>，大幅減少重復 DAO 代碼。
5. Service + Controller 快速 CRUD 示例
5.1 Service（直接使用 MP 的 Service 接口）
如果你喜歡 Service 層抽象，可以使用 MyBatis-Plus 的 IService 與 ServiceImpl：
package com.example.demo.service;
import com.baomidou.mybatisplus.extension.service.IService;
import com.example.demo.entity.User;
public interface IUserService extends IService<User> {
// 自定義業(yè)務方法可以在這里擴展
}實現類：
package com.example.demo.service.impl;
import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl;
import com.example.demo.entity.User;
import com.example.demo.mapper.UserMapper;
import com.example.demo.service.IUserService;
import org.springframework.stereotype.Service;
@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements IUserService {
// 使用內置的 save/update/getById/list 等方法
}5.2 Controller 示例
package com.example.demo.controller;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.example.demo.entity.User;
import com.example.demo.service.IUserService;
import org.springframework.web.bind.annotation.*;
import javax.annotation.Resource;
import java.util.List;
@RestController
@RequestMapping("/users")
public class UserController {
@Resource
private IUserService userService;
@GetMapping("/{id}")
public User get(@PathVariable Long id) {
return userService.getById(id);
}
@GetMapping
public Page<User> list(@RequestParam(defaultValue = "1") long page,
@RequestParam(defaultValue = "10") long size,
@RequestParam(required = false) String name) {
Page<User> p = new Page<>(page, size);
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
if (name != null && !name.isEmpty()) {
wrapper.like(User::getUsername, name);
}
return userService.page(p, wrapper);
}
@PostMapping
public boolean create(@RequestBody User user) {
return userService.save(user);
}
@PutMapping("/{id}")
public boolean update(@PathVariable Long id, @RequestBody User user) {
user.setId(id);
return userService.updateById(user);
}
@DeleteMapping("/{id}")
public boolean delete(@PathVariable Long id) {
// 若啟用了邏輯刪除，則會被標記為已刪除
return userService.removeById(id);
}
}說明：
- userService.page(page, wrapper)：內置分頁接口，配合分頁插件使用；
- LambdaQueryWrapper：類型安全的條件構造器（避免寫錯字段名）。
6. 分頁與條件構造器重點說明
- MyBatis-Plus 的分頁是插件驅動：需要配置分頁插件（下一節(jié)會展示）。分頁查詢只要傳入 Page 對象即可自動分頁并返回 IPage/Page 對象。
- QueryWrapper 和 LambdaQueryWrapper 是常用的條件構造器，Lambda 方式優(yōu)點是重命名/重構字段更安全。
示例（復合條件）：
LambdaQueryWrapper<User> wrapper = new LambdaQueryWrapper<>();
wrapper.ge(User::getAge, 18)
.le(User::getAge, 40)
.like(User::getUsername, "張");7. 常見插件配置（分頁 / 樂觀鎖 / 邏輯刪除 / 自動填充）
在 Spring Boot 的配置類中注冊插件。
package com.example.demo.config;
import com.baomidou.mybatisplus.extension.plugins.MybatisPlusInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.PaginationInnerInterceptor;
import com.baomidou.mybatisplus.extension.plugins.inner.OptimisticLockerInnerInterceptor;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class MybatisPlusConfig {
@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
// 分頁（針對 MySQL）
interceptor.addInnerInterceptor(new PaginationInnerInterceptor());
// 樂觀鎖
interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
// 其他插件（如防止全表更新等）可在此追加
return interceptor;
}
}說明要點：
- PaginationInnerInterceptor：負責分頁攔截；
- OptimisticLockerInnerInterceptor：啟用 @Version 樂觀鎖注解支持；
- 邏輯刪除在實體上加 @TableLogic，并在 application.yml 做對齊配置（見上文）。
- 官方文檔對這些功能有說明，建議參考官方快速入門與配置章節(jié)。
8. 常見問題與調試技巧
1. SQL 不打印？
- 配置日志級別（application.yml）：
logging:
level:
com.baomidou.mybatisplus: debug
org.mybatis: debug
com.example.demo: debug或使用 mybatis-plus.configuration.log-impl 指定 Slf4jImpl（部分版本需要）。查看日志可以幫助定位 SQL 與參數
2. 分頁不起作用
- 確認注冊了 MybatisPlusInterceptor 與 PaginationInnerInterceptor。
- 確認調用 page(new Page<>(page, size), wrapper) 而不是自己寫 limit。
3. 樂觀鎖失敗卻無異常
- 需要在實體上標注 @Version 并在更新時使用 updateById / update，MP 會自動帶上版本條件（WHERE version = ?），如果更新條數為 0表示沖突。
4. 邏輯刪除仍能被查詢到
- 確認實體字段有 @TableLogic，同時 global-config.db-config 的logic-delete-field/值是否對應。MP 會在查詢時自動過濾被標記的行。
5. Mapper XML 與 注解 混用
- 若使用 XML，確保 mapperLocations 指向 XML 路徑，且 @MapperScan 或 @Mapper 在 mapper
接口上生效。
9. 小結（為什么選 MyBatis-Plus）
- MyBatis-Plus 在 MyBatis 基礎上做了大量“零侵入”增強，提供了 BaseMapper、條件構造器、分頁、代碼生成器等常用工具，大幅減少模板 CRUD 代碼。官方和社區(qū)對 Spring Boot 3 有專門的 starter，方便集成
10. 參考 & 延伸閱讀
- MyBatis-Plus 官方文檔（快速開始 / 插件 / 分頁 / 代碼生成等）。
- MyBatis-Plus 在 Maven 中央倉庫的 artifact 列表（查看可用版本）。
- GitHub 源碼和示例倉庫（官方/社區(qū)）。
- Baeldung 的 MyBatis-Plus 入門文章（英文參考）
到此這篇關于Spring Boot 3.0 + MyBatis-Plus全家桶實戰(zhàn)的文章就介紹到這了,更多相關Spring Boot 3.0+MyBatis-Plus全家桶內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！
相關文章
Java中對象?和?json?互轉四種方式?json-lib、Gson、FastJson、Jackson
這篇文章主要介紹了Java中對象?和?json?互轉?四種方式?json-lib、Gson、FastJson、Jackson,需要的朋友可以參考下2023-11-11
這篇文章主要介紹了Java代碼實現微信頁面滾動防露底的相關資料,非常不錯，具有參考借鑒價值，需要的朋友可以參考下2016-09-09
這篇文章主要介紹了如何處理maven倉庫中后綴LastUpdated文件,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下2020-04-04
這篇文章主要介紹了解決使用@ResponseBody后返回500錯誤的問題，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧2020-09-09
這篇文章主要介紹了如何用Java核心庫實現簡單的AOP，幫助大家為了更好的理解和學習AOP的思想，感興趣的朋友可以了解下2020-08-08
本文主要介紹了Java死鎖產生原因及示例，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2023-06-06
這篇文章主要為大家詳細介紹了Java實現TCP互發(fā)消息，文中示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下2020-07-07
這篇文章主要介紹了java之Objects.nonNull用法代碼,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教2025-03-03
這篇文章主要介紹了Java動態(tài)代理和反射機制，文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值，需要的朋友們下面隨著小編來一起學習學習吧2019-03-03
這篇文章主要介紹了Java中EnumMap代替序數索引代碼詳解，小編覺得還是挺不錯的，具有一定借鑒價值，需要的朋友可以參考下2018-02-02