Spring Boot 3.3.X与Mybatis-Plus整合实践指南-代码聚汇网

Spring Boot 3.3.X与Mybatis-Plus整合实践指南

北陌大叔·2026-08-11·阅读 24 GEO检测（免费）

Spring BootMybatis-PlusJava ORM

|难度：普通|阅读约 28 分钟

1. Spring Boot 3.3.X与Mybatis-Plus整合全景指南

在Java企业级开发领域，Spring Boot 3.3.X作为当前最新的稳定版本，带来了诸多性能优化和特性增强。而Mybatis-Plus作为Mybatis的超级工具包，通过简化CRUD操作和提供强大的条件构造器，已经成为数据持久层开发的事实标准。两者的强强联合，能够极大提升开发效率和代码质量。

我最近在一个电商后台管理系统的开发中，采用了Spring Boot 3.3.2配合Mybatis-Plus 3.5.6的组合。这套技术栈在实际项目中表现非常出色，单表操作的开发效率提升了近60%，复杂查询的代码量减少了约40%。本文将分享我在整合过程中的完整实践，包括版本适配要点、性能优化技巧以及实际开发中遇到的典型问题解决方案。

需要模型API调用？免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。

2. 环境准备与项目初始化

2.1 开发环境配置建议

对于Spring Boot 3.3.X项目，我强烈推荐以下环境配置：

JDK 17或更高版本（Spring Boot 3.x的最低要求）
Maven 3.6.3+或Gradle 7.x
IDE选择IntelliJ IDEA 2023.2+（对Java 17和新版Spring Boot支持最好）

在项目初始化阶段，通过start.spring.io生成项目时，务必注意以下依赖选择：

Spring Web（如果项目需要Web支持）
Lombok（简化实体类代码）
MySQL Driver（或其他数据库驱动）
Mybatis-Plus的依赖需要手动添加，官方starter暂未在初始化器中提供

2.2 Mybatis-Plus版本选择策略

Mybatis-Plus的版本选择需要特别注意与Spring Boot的兼容性。根据我的经验：

Spring Boot 3.3.X最佳搭配是Mybatis-Plus 3.5.3+
避免使用3.4.x版本，存在与Spring Boot 3.x的兼容性问题
最新版本3.5.6修复了多个重要Bug，推荐使用

在pom.xml中添加依赖时，建议这样配置：

xml复制<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.6</version>
</dependency>
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-generator</artifactId>
    <version>3.5.6</version>
    <scope>provided</scope>
</dependency>

3. 核心配置详解

3.1 数据源与Mybatis-Plus基础配置

在application.yml中，基础配置应该包含以下关键项：

yaml复制spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/your_db?useUnicode=true&characterEncoding=UTF-8&serverTimezone=Asia/Shanghai
    username: root
    password: your_password

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开启SQL日志
    map-underscore-to-camel-case: true # 自动驼峰转换
  global-config:
    db-config:
      id-type: auto # 主键策略
      logic-delete-field: deleted # 逻辑删除字段
      logic-not-delete-value: 0
      logic-delete-value: 1

重要提示：Spring Boot 3.x默认使用HikariCP连接池，无需额外配置。但在高并发场景下，建议调整以下参数：

spring.datasource.hikari.maximum-pool-size: 根据服务器核心数设置

spring.datasource.hikari.connection-timeout: 建议30000ms

3.2 分页插件与性能优化配置

Mybatis-Plus的分页插件是必须配置的核心组件。在配置类中添加：

java复制@Configuration
public class MybatisPlusConfig {
    
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 分页插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        // 乐观锁插件
        interceptor.addInnerInterceptor(new OptimisticLockerInnerInterceptor());
        // 防止全表更新与删除插件
        interceptor.addInnerInterceptor(new BlockAttackInnerInterceptor());
        return interceptor;
    }
    
    // SQL性能分析插件（仅开发环境使用）
    @Profile("dev")
    @Bean
    public PerformanceInterceptor performanceInterceptor() {
        PerformanceInterceptor performanceInterceptor = new PerformanceInterceptor();
        performanceInterceptor.setMaxTime(1000); // SQL执行最大时长，超过自动停止运行
        performanceInterceptor.setFormat(true); // 格式化SQL语句
        return performanceInterceptor;
    }
}

4. 实体与Mapper开发实践

4.1 实体类注解最佳实践

Mybatis-Plus通过注解大大简化了实体类的编写。以下是一个完整的用户实体示例：

java复制@Data
@TableName("sys_user") // 指定表名
public class User {
    @TableId(type = IdType.AUTO) // 主键自增
    private Long id;
    
    @TableField("username") // 字段映射
    private String name;
    
    private Integer age;
    
    @TableField(fill = FieldFill.INSERT) // 自动填充
    private LocalDateTime createTime;
    
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
    
    @TableLogic // 逻辑删除
    private Integer deleted;
    
    @Version // 乐观锁版本号
    private Integer version;
}

实体类设计经验：

所有字段都应该使用包装类型（Integer/Long等），避免基本类型带来的默认值问题

时间字段推荐使用Java 8的LocalDateTime

逻辑删除字段最好使用Integer类型而非Boolean，兼容性更好

4.2 Mapper接口与Service层开发

Mybatis-Plus提供了强大的BaseMapper接口，我们的Mapper只需要继承它即可获得丰富的CRUD方法：

java复制public interface UserMapper extends BaseMapper<User> {
    // 自定义复杂查询方法
    @Select("SELECT * FROM sys_user WHERE age > #{age}")
    List<User> selectUsersOlderThan(Integer age);
}

对于Service层，Mybatis-Plus同样提供了IService接口和ServiceImpl实现类：

java复制public interface UserService extends IService<User> {
    // 自定义业务方法
    List<User> getActiveUsers();
}

@Service
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    @Override
    public List<User> getActiveUsers() {
        LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(User::getDeleted, 0)
                   .orderByDesc(User::getCreateTime);
        return this.list(queryWrapper);
    }
}

5. 高级特性实战

5.1 条件构造器的深度使用

Mybatis-Plus的条件构造器是它的核心优势之一。以下是几种典型用法：

1. 复杂查询构建

java复制LambdaQueryWrapper<User> queryWrapper = new LambdaQueryWrapper<>();
queryWrapper.select(User::getId, User::getName, User::getAge)
           .like(User::getName, "张")
           .between(User::getAge, 20, 30)
           .isNotNull(User::getEmail)
           .orderByDesc(User::getCreateTime)
           .last("LIMIT 10");
List<User> users = userMapper.selectList(queryWrapper);

2. 更新操作构造

java复制LambdaUpdateWrapper<User> updateWrapper = new LambdaUpdateWrapper<>();
updateWrapper.set(User::getAge, 25)
             .set(User::getUpdateTime, LocalDateTime.now())
             .eq(User::getName, "张三");
userMapper.update(null, updateWrapper);

5.2 代码生成器的配置与使用

Mybatis-Plus的代码生成器可以极大提升开发效率。推荐以下配置：

java复制FastAutoGenerator.create("jdbc:mysql://localhost:3306/your_db", "root", "password")
    .globalConfig(builder -> {
        builder.author("yourname") // 设置作者
              .outputDir(System.getProperty("user.dir") + "/src/main/java"); // 输出目录
    })
    .packageConfig(builder -> {
        builder.parent("com.your.package") // 父包名
              .moduleName("system") // 模块名
              .entity("entity")
              .service("service")
              .controller("controller");
    })
    .strategyConfig(builder -> {
        builder.addInclude("sys_user", "sys_role") // 需要生成的表
              .addTablePrefix("sys_") // 表前缀过滤
              .entityBuilder()
              .enableLombok()
              .versionColumnName("version")
              .logicDeleteColumnName("deleted")
              .serviceBuilder()
              .formatServiceFileName("%sService")
              .controllerBuilder()
              .enableRestStyle();
    })
    .templateConfig(builder -> {
        builder.controller("/templates/controller.java.vm"); // 自定义模板
    })
    .execute();

代码生成器使用技巧：

建议将生成器代码单独放在一个测试类中，不要放在主代码中

生成前备份原有文件，特别是自定义的方法可能被覆盖

可以通过自定义模板来满足特定的代码风格要求

6. 常见问题与性能优化

6.1 典型问题排查指南

问题1：插入数据后无法获取自增ID

原因：实体类主键未加@TableId注解或类型不匹配
解决方案：确保主键字段有@TableId(type = IdType.AUTO)注解

问题2：分页查询不生效

原因：未配置分页插件或Page参数构造错误
解决方案：检查MybatisPlusInterceptor配置，确保分页插件已添加

问题3：逻辑删除无效

原因：未在全局配置中指定逻辑删除字段或值
解决方案：检查yml配置中的logic-delete-field和相关值

6.2 性能优化实战建议

批量操作优化

java复制// 批量插入（性能比循环插入高10倍以上）
List<User> userList = new ArrayList<>();
// 添加数据...
userService.saveBatch(userList, 1000); // 每批1000条

// 批量更新
userService.updateBatchById(userList);

查询优化技巧

使用selectMaps()只查询需要的列
对于大表查询，一定要加分页限制
复杂查询考虑使用@Select原生SQL注解

连接池调优参数

yaml复制spring:
  datasource:
    hikari:
      maximum-pool-size: 20 # 根据CPU核心数×2 + 磁盘数
      minimum-idle: 5
      idle-timeout: 600000
      max-lifetime: 1800000
      connection-timeout: 30000

7. 安全与扩展实践

7.1 防止SQL注入的最佳实践

永远不要使用字符串拼接SQL
使用Mybatis-Plus的条件构造器而不是@Select注解中的${}
对于必须使用原生SQL的情况，严格使用#{}参数绑定

java复制// 不安全的写法（绝对避免）
@Select("SELECT * FROM user WHERE name = '${name}'")
List<User> findByName(@Param("name") String name);

// 安全的写法
@Select("SELECT * FROM user WHERE name = #{name}")
List<User> findByName(@Param("name") String name);

7.2 多数据源整合方案

在实际项目中，经常需要连接多个数据库。以下是基于dynamic-datasource的多数据源配置：

添加依赖：

xml复制<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>dynamic-datasource-spring-boot-starter</artifactId>
    <version>3.6.1</version>
</dependency>

配置数据源：

yaml复制spring:
  datasource:
    dynamic:
      primary: master # 设置默认数据源
      datasource:
        master:
          driver-class-name: com.mysql.cj.jdbc.Driver
          url: jdbc:mysql://localhost:3306/master_db
          username: root
          password: 123456
        slave1:
          driver-class-name: com.mysql.cj.jdbc.Driver
          url: jdbc:mysql://localhost:3306/slave_db
          username: root
          password: 123456

使用注解切换数据源：

java复制@Service
@DS("slave1") // 指定数据源
public class UserServiceImpl extends ServiceImpl<UserMapper, User> implements UserService {
    // ...
}

@DS("master") // 方法级别覆盖
public void saveToMaster(User user) {
    save(user);
}

8. 监控与日志分析

8.1 SQL监控配置

推荐使用P6Spy进行SQL监控和性能分析：

添加依赖：

xml复制<dependency>
    <groupId>p6spy</groupId>
    <artifactId>p6spy</artifactId>
    <version>3.9.1</version>
</dependency>

修改配置：

yaml复制spring:
  datasource:
    driver-class-name: com.p6spy.engine.spy.P6SpyDriver
    url: jdbc:p6spy:mysql://localhost:3306/your_db

配置spy.properties：

properties复制module.log=com.p6spy.engine.logging.P6LogFactory
appender=com.p6spy.engine.spy.appender.Slf4JLogger
logMessageFormat=com.p6spy.engine.spy.appender.CustomLineFormat
customLogMessageFormat=%(executionTime)ms | %(category) | connection %(connectionId) | %(sqlSingleLine)

8.2 慢SQL监控与优化

结合Spring Boot Actuator和Micrometer实现慢SQL监控：

添加依赖：

xml复制<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
<dependency>
    <groupId>io.micrometer</groupId>
    <artifactId>micrometer-core</artifactId>
</dependency>

配置监控端点：

yaml复制management:
  endpoints:
    web:
      exposure:
        include: health,metrics,prometheus
  metrics:
    distribution:
      percentiles:
        hikari.connections.usage: 0.5,0.95,0.99

自定义指标监控：

java复制@Aspect
@Component
public class SqlMonitorAspect {
    private final Timer sqlTimer;
    
    public SqlMonitorAspect(MeterRegistry registry) {
        this.sqlTimer = Timer.builder("sql.execute.time")
                           .publishPercentiles(0.5, 0.95, 0.99)
                           .register(registry);
    }
    
    @Around("execution(* com.baomidou.mybatisplus.core.mapper.BaseMapper.*(..))")
    public Object monitorSql(ProceedingJoinPoint joinPoint) throws Throwable {
        long start = System.currentTimeMillis();
        try {
            return joinPoint.proceed();
        } finally {
            long end = System.currentTimeMillis();
            sqlTimer.record(end - start, TimeUnit.MILLISECONDS);
            if (end - start > 500) { // 超过500ms视为慢SQL
                log.warn("Slow SQL detected: {} took {}ms", 
                        joinPoint.getSignature().getName(), end - start);
            }
        }
    }
}