1. SpringBoot3与MybatisPlus整合概述
在Java企业级应用开发中，持久层框架的选择直接影响着开发效率和系统性能。MybatisPlus作为Mybatis的增强工具，在保留Mybatis所有特性的基础上，进一步简化了CRUD操作。SpringBoot3作为最新一代的快速开发框架，与MybatisPlus的结合能够显著提升开发体验。
我最近在一个电商后台管理系统中采用了这套技术组合，实测单表CRUD操作的开发时间比传统Mybatis减少了约60%。特别是在Mapper层的实现上，MybatisPlus的BaseMapper接口已经内置了绝大多数常用方法，开发者只需要通过简单的继承就能获得完整的数据库操作能力。
2. 环境准备与项目配置
2.1 依赖引入
首先需要在pom.xml中添加必要的依赖。对于SpringBoot3项目，要特别注意版本兼容性问题：
<dependencies> <!-- SpringBoot Starter --> <dependency> <groupId>org.springframework.boot</groupId> <artifactId>spring-boot-starter-web</artifactId> <version>3.0.0</version> </dependency> <!-- MybatisPlus Starter --> <dependency> <groupId>com.baomidou</groupId> <artifactId>mybatis-plus-boot-starter</artifactId> <version>3.5.3.1</version> </dependency> <!-- 数据库驱动 --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>8.0.32</version> </dependency> </dependencies>注意：SpringBoot3需要Java17+环境，同时MybatisPlus 3.5.x版本开始全面支持SpringBoot3的特性。
2.2 配置文件设置
在application.yml中配置数据源和MybatisPlus相关属性：
spring: datasource: url: jdbc:mysql://localhost:3306/demo_db?useSSL=false&serverTimezone=UTC username: root password: yourpassword driver-class-name: com.mysql.cj.jdbc.Driver mybatis-plus: configuration: log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开启SQL日志 global-config: db-config: id-type: auto # 主键自增策略3. 实体类与Mapper创建
3.1 实体类定义
假设我们有一个用户表，对应的实体类可以这样定义：
import com.baomidou.mybatisplus.annotation.TableId; import com.baomidou.mybatisplus.annotation.TableName; @TableName("t_user") // 指定表名 public class User { @TableId // 标识主键 private Long id; private String username; private Integer age; private String email; // 省略getter/setter和toString方法 }3.2 Mapper接口实现
这是最核心的部分，MybatisPlus的魔法就体现在这里：
import com.baomidou.mybatisplus.core.mapper.BaseMapper; public interface UserMapper extends BaseMapper<User> { // 不需要任何方法声明，BaseMapper已经提供了完整的CRUD方法 }BaseMapper接口中已经预定义了如下常用方法：
- insert(T entity): 插入一条记录
- deleteById(Serializable id): 根据ID删除
- updateById(T entity): 根据ID修改
- selectById(Serializable id): 根据ID查询
- selectList(Wrapper queryWrapper): 条件查询列表
4. 服务层与控制器实现
4.1 服务层封装
虽然可以直接在Controller中使用Mapper，但良好的实践应该通过Service层进行封装：
@Service public class UserService { @Autowired private UserMapper userMapper; public boolean saveUser(User user) { return userMapper.insert(user) > 0; } public User getUserById(Long id) { return userMapper.selectById(id); } // 其他业务方法... }4.2 控制器暴露API
@RestController @RequestMapping("/users") public class UserController { @Autowired private UserService userService; @PostMapping public Result save(@RequestBody User user) { boolean success = userService.saveUser(user); return success ? Result.success() : Result.fail("添加失败"); } @GetMapping("/{id}") public Result getById(@PathVariable Long id) { User user = userService.getUserById(id); return Result.success(user); } }5. 高级特性与自定义SQL
5.1 条件构造器使用
MybatisPlus提供了强大的条件构造器Wrapper，可以构建复杂的查询条件：
// 查询年龄大于18且邮箱不为空的用户 QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.gt("age", 18) .isNotNull("email"); List<User> users = userMapper.selectList(wrapper);5.2 自定义SQL语句
虽然BaseMapper已经很强大了，但复杂查询还是需要自定义SQL：
public interface UserMapper extends BaseMapper<User> { @Select("SELECT * FROM t_user WHERE age > #{minAge} AND age < #{maxAge}") List<User> selectByAgeRange(@Param("minAge") int minAge, @Param("maxAge") int maxAge); }6. 常见问题与解决方案
6.1 表名映射问题
如果实体类名和表名不一致，可以通过@TableName注解指定：
@TableName("sys_user") // 实际表名 public class User { // ... }6.2 字段名映射问题
字段名不一致时使用@TableField注解：
@TableField("user_name") // 实际字段名 private String username;6.3 主键策略选择
MybatisPlus支持多种主键策略，可以在全局配置或通过注解指定：
@TableId(type = IdType.AUTO) // 数据库自增 private Long id; // 其他策略： // IdType.NONE: 无策略 // IdType.INPUT: 手动输入 // IdType.ASSIGN_ID: 雪花算法生成ID // IdType.ASSIGN_UUID: UUID7. 性能优化建议
7.1 批量操作
对于批量插入，使用MybatisPlus的批量操作方法：
List<User> userList = new ArrayList<>(); // 添加多个用户对象... // 批量插入 boolean success = userService.saveBatch(userList);7.2 逻辑删除
实现逻辑删除而非物理删除：
mybatis-plus: global-config: db-config: logic-delete-field: deleted # 逻辑删除字段名 logic-not-delete-value: 0 # 未删除值 logic-delete-value: 1 # 删除值然后在实体类中添加对应字段：
@TableLogic private Integer deleted;8. 实际开发中的经验分享
在最近的项目中，我发现MybatisPlus的Lambda表达式写法可以避免字段名的硬编码，大大提高了代码的可维护性：
// 传统写法 QueryWrapper<User> wrapper = new QueryWrapper<>(); wrapper.eq("age", 18); // Lambda写法 LambdaQueryWrapper<User> lambdaWrapper = new LambdaQueryWrapper<>(); lambdaWrapper.eq(User::getAge, 18);另一个实用技巧是自动填充功能。比如创建时间和更新时间可以这样实现：
public class User { @TableField(fill = FieldFill.INSERT) private LocalDateTime createTime; @TableField(fill = FieldFill.INSERT_UPDATE) private LocalDateTime updateTime; }然后实现MetaObjectHandler接口：
@Component public class MyMetaObjectHandler implements MetaObjectHandler { @Override public void insertFill(MetaObject metaObject) { this.strictInsertFill(metaObject, "createTime", LocalDateTime.class, LocalDateTime.now()); } @Override public void updateFill(MetaObject metaObject) { this.strictUpdateFill(metaObject, "updateTime", LocalDateTime.class, LocalDateTime.now()); } }这套技术组合在实际项目中表现非常出色，特别是在快速迭代的业务场景下。我建议在开始新项目时，可以先用MybatisPlus快速搭建CRUD功能，等业务稳定后再针对复杂场景进行定制化开发。
