Spring Boot整合MyBatis-Plus开发实践与优化-代码聚汇网

Spring Boot整合MyBatis-Plus开发实践与优化

股海求生·2026-08-19·阅读 21 GEO检测（免费）

Spring BootMyBatis-PlusORM框架

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

1. 为什么选择MyBatis-Plus与Spring Boot组合

在Java企业级开发领域，数据持久层框架的选择往往决定了项目的开发效率和后期维护成本。MyBatis作为老牌的ORM框架，以其灵活的SQL编写方式和良好的性能表现赢得了大量开发者的青睐。而MyBatis-Plus作为MyBatis的增强工具，在保留MyBatis所有特性的基础上，进一步简化了开发流程。

Spring Boot与MyBatis-Plus的组合之所以成为当前企业开发的热门选择，主要基于以下几个核心优势：

零配置快速启动：Spring Boot的自动配置机制与MyBatis-Plus的默认配置完美结合，开发者几乎不需要编写任何XML配置文件即可开始数据库操作
强大的CRUD操作：MyBatis-Plus内置了通用Mapper和Service，单表CRUD操作无需编写任何方法
丰富的功能扩展：从分页插件、性能分析插件到多租户支持，MyBatis-Plus提供了企业级应用所需的各种功能
活跃的社区生态：两者都有庞大的用户群体和持续更新的版本迭代，遇到问题能够快速找到解决方案

实际项目经验表明，在中小型项目中，采用Spring Boot+MyBatis-Plus的组合相比传统SSM框架，能够减少约40%的持久层代码量，同时保持相同的灵活性和性能表现。

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

2. 项目环境准备与基础配置

2.1 创建Spring Boot项目

首先通过Spring Initializr创建基础项目，关键依赖选择：

Spring Web (用于构建Web应用)
MyBatis Framework (基础MyBatis支持)
MySQL Driver (或其他数据库驱动)

创建完成后，在pom.xml中添加MyBatis-Plus的依赖：

xml复制<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.5.3.1</version>
</dependency>

版本选择建议：始终使用MyBatis-Plus官网推荐的最新稳定版，避免使用快照版本(SNAPSHOT)在生产环境中。

2.2 数据库连接配置

在application.yml中配置数据库连接信息：

yaml复制spring:
  datasource:
    driver-class-name: com.mysql.cj.jdbc.Driver
    url: jdbc:mysql://localhost:3306/your_database?useSSL=false&serverTimezone=UTC
    username: root
    password: your_password

mybatis-plus:
  configuration:
    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl # 开启SQL日志
  global-config:
    db-config:
      id-type: auto # 主键生成策略

关键配置项说明：

log-impl：开发阶段建议开启，方便调试SQL
id-type：设置主键生成策略，auto表示数据库ID自增

2.3 实体类与Mapper基础配置

创建实体类示例：

java复制@Data
@TableName("sys_user") // 指定表名
public class User {
    @TableId(type = IdType.AUTO) // 主键自增
    private Long id;
    
    private String username;
    private String password;
    
    @TableField("create_time") // 字段映射
    private LocalDateTime createTime;
}

创建Mapper接口：

java复制public interface UserMapper extends BaseMapper<User> {
    // 无需编写任何方法，基本的CRUD操作已由BaseMapper提供
}

使用Lombok的@Data注解可以自动生成getter/setter等方法，但需要确保IDE已安装Lombok插件。

3. MyBatis-Plus核心功能配置详解

3.1 分页插件配置

分页是企业应用中最常用的功能之一，MyBatis-Plus提供了强大的分页插件。配置方法如下：

java复制@Configuration
public class MybatisPlusConfig {
    
    @Bean
    public MybatisPlusInterceptor mybatisPlusInterceptor() {
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
        // 分页插件
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));
        return interceptor;
    }
}

使用示例：

java复制// 分页查询
Page<User> page = new Page<>(1, 10); // 当前页，每页大小
Page<User> result = userMapper.selectPage(page, null);

3.2 自动填充功能配置

对于创建时间、更新时间等通用字段，可以使用自动填充功能：

在实体类中添加注解：

java复制public class User {
    // ...
    
    @TableField(fill = FieldFill.INSERT)
    private LocalDateTime createTime;
    
    @TableField(fill = FieldFill.INSERT_UPDATE)
    private LocalDateTime updateTime;
}

实现MetaObjectHandler接口：

java复制@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());
    }
}

3.3 逻辑删除配置

逻辑删除是企业应用中常见需求，配置方法：

在application.yml中添加配置：

yaml复制mybatis-plus:
  global-config:
    db-config:
      logic-delete-field: deleted # 逻辑删除字段名
      logic-not-delete-value: 0   # 未删除值
      logic-delete-value: 1       # 删除值

实体类中添加字段：

java复制@TableLogic
private Integer deleted;

配置后，调用delete方法将自动变为更新操作，将deleted字段设置为1。

4. 高级功能与性能优化

4.1 多租户实现方案

在SaaS应用中，多租户是常见需求。MyBatis-Plus提供了多租户插件：

java复制@Bean
public MybatisPlusInterceptor mybatisPlusInterceptor() {
    MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();
    
    // 多租户插件
    TenantLineInnerInterceptor tenantInterceptor = new TenantLineInnerInterceptor();
    tenantInterceptor.setTenantLineHandler(new TenantLineHandler() {
        @Override
        public String getTenantIdColumn() {
            return "tenant_id"; // 租户字段名
        }
        
        @Override
        public Expression getTenantId() {
            // 从当前上下文中获取租户ID
            return new StringValue("current_tenant_id");
        }
        
        @Override
        public boolean ignoreTable(String tableName) {
            // 忽略不需要租户隔离的表
            return !"sys_user".equals(tableName);
        }
    });
    
    interceptor.addInnerInterceptor(tenantInterceptor);
    return interceptor;
}

4.2 性能分析插件

开发阶段可以使用性能分析插件监控SQL执行：

java复制@Bean
@Profile({"dev", "test"}) // 只在开发测试环境使用
public PerformanceInterceptor performanceInterceptor() {
    PerformanceInterceptor performanceInterceptor = new PerformanceInterceptor();
    performanceInterceptor.setMaxTime(1000); // SQL执行最大时长，超过自动停止运行
    performanceInterceptor.setFormat(true); // 格式化SQL
    return performanceInterceptor;
}

4.3 动态表名支持

对于分表场景，可以实现动态表名：

java复制public class MyTableNameHandler implements TableNameHandler {
    
    @Override
    public String dynamicTableName(String sql, String tableName) {
        // 根据业务逻辑返回实际表名
        if ("order".equals(tableName)) {
            return "order_" + LocalDate.now().getYear();
        }
        return tableName;
    }
}

配置插件：

java复制DynamicTableNameInnerInterceptor dynamicTableNameInnerInterceptor = new DynamicTableNameInnerInterceptor();
dynamicTableNameInnerInterceptor.setTableNameHandler(new MyTableNameHandler());
interceptor.addInnerInterceptor(dynamicTableNameInnerInterceptor);

5. 常见问题与解决方案

5.1 字段映射问题

问题现象：实体类字段与数据库列名不一致导致查询结果为空。

解决方案：

使用@TableField注解明确指定映射关系
配置全局下划线转驼峰：

yaml复制mybatis-plus:
  configuration:
    map-underscore-to-camel-case: true

5.2 分页插件不生效

可能原因：

未正确配置分页插件
自定义SQL未使用Page参数