异常教程

mybatisplus依赖（一文讲透）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

  • 新项目:《从零手撸：仿小红书（微服务架构）》 正在持续爆肝中，基于 Spring Cloud Alibaba + Spring Boot 3.x + JDK 17...，点击查看项目介绍 ;
  • 《从零手撸：前后端分离博客项目（全栈开发）》 2 期已完结，演示链接： http://116.62.199.48/ ;

截止目前， 星球 内专栏累计输出 82w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 2900+ 小伙伴加入学习 ，欢迎点击围观

前言

在Java后端开发中，数据库操作是核心任务之一。随着业务复杂度的提升，传统MyBatis的XML配置方式逐渐显露出重复代码多、维护成本高的问题。MyBatis-Plus作为MyBatis的增强工具包，通过封装常用功能，极大简化了CRUD操作。而mybatisplus依赖的正确配置，正是使用这一框架的基础。本文将从依赖引入、核心模块、配置优化到实战案例，逐步拆解如何高效利用MyBatis-Plus的依赖体系。

一、MyBatis-Plus依赖的引入方式

1. 依赖的核心作用

可以将mybatisplus依赖比喻为“开发框架的基石”。它不仅包含基础功能模块（如通用Mapper），还集成了数据库连接、分页插件、性能优化工具等扩展功能。通过合理引入不同依赖模块，开发者可以按需组合，避免“全量引入”的冗余。

（1）Maven依赖配置示例

对于Spring Boot项目，推荐使用官方提供的starter依赖：

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

此依赖已包含核心模块（如mybatis-plus-core）和Spring Boot集成组件，适合快速搭建项目。

（2）独立项目依赖配置

若项目不基于Spring Boot，需手动组合基础依赖：

<!-- 核心功能 -->  
<dependency>  
  <groupId>com.baomidou</groupId>  
  <artifactId>mybatis-plus-core</artifactId>  
  <version>3.5.3</version>  
</dependency>  

<!-- MyBatis整合 -->  
<dependency>  
  <groupId>com.baomidou</groupId>  
  <artifactId>mybatis-plus-extension</artifactId>  
  <version>3.5.3</version>  
</dependency>

（3）扩展功能按需引入

例如添加分页插件时：

<dependency>  
  <groupId>com.baomidou</groupId>  
  <artifactId>mybatis-plus-extension</artifactId>  
  <version>3.5.3</version>  
</dependency>

通过模块化依赖，开发者可以精准控制项目依赖体积。

二、MyBatis-Plus核心依赖模块解析

1. 模块化设计原理

MyBatis-Plus采用“模块化依赖”设计，类似乐高积木的组合方式。每个模块负责特定功能，如下表所示：

模块名称功能描述
mybatis-plus-core核心功能，包含基础CRUD、SQL构建器、元数据解析等
mybatis-plus-extension扩展功能，如分页插件、性能分析、国际化支持等
mybatis-plus-boot-starterSpring Boot整合包，自动配置MyBatis-Plus与Spring的集成

类比说明：这就像汽车的发动机（core）和导航系统（extension），核心模块提供基础动力，扩展模块则增强驾驶体验。

2. 核心模块的关键类

（1）BaseMapper接口

这是MyBatis-Plus的“魔法接口”，通过继承该接口，实体类的DAO层可直接获得以下能力：

public interface UserMapper extends BaseMapper<User> {  
    // 继承后自动获得selectById、updateById等方法  
}

比喻：就像为开发者提供了一把“万能钥匙”，无需手动编写基础SQL。

（2）SqlHelper工具类

该类封装了SQL构建逻辑，例如动态条件查询：

QueryWrapper<User> wrapper = new QueryWrapper<>();  
wrapper.eq("status", 1).likeRight("name", "Tom");  
List<User> list = userMapper.selectList(wrapper);

通过链式调用，代码可读性显著提升。

三、依赖配置与优化实践

1. 自动配置的“隐式能力”

在Spring Boot项目中，引入mybatis-plus-boot-starter后，框架会自动执行以下操作：

  • 扫描@Mapper注解的接口
  • 注册MetaObjectHandler实现字段自动填充
  • 配置GlobalConfiguration默认参数

示例配置：

mybatis-plus:  
  configuration:  
    map-underscore-to-camel-case: true  # 自动转换下划线命名  
  global-config:  
    db-config:  
      id-type: auto  # 主键自动生成策略

2. 性能优化配置

通过依赖的扩展模块，可实现以下优化：

（1）分页插件配置

@Configuration  
public class MyBatisPlusConfig {  
    @Bean  
    public MybatisPlusInterceptor interceptor() {  
        MybatisPlusInterceptor interceptor = new MybatisPlusInterceptor();  
        interceptor.addInnerInterceptor(new PaginationInnerInterceptor(DbType.MYSQL));  
        return interceptor;  
    }  
}

此配置将分页逻辑从应用层转移到数据库层，提升查询效率。

（2）SQL执行日志

logging:  
  level:  
    com.baomidou.mybatisplus.extension: debug

通过日志输出，可直观查看MyBatis-Plus生成的SQL语句，便于调试。

四、实战案例：基于依赖的完整项目搭建

1. 项目结构设计

src/main/java  
├── config/MyBatisPlusConfig.java  # 配置拦截器  
├── entity/User.java               # 实体类  
├── mapper/UserMapper.java         # 继承BaseMapper  
└── service/UserService.java       # 业务逻辑层

2. 关键代码实现

（1）实体类

@Data  
public class User {  
    private Long id;  
    private String name;  
    private Integer age;  
    private Date createTime;  // 自动填充字段  
}

（2）自动填充配置

@Component  
public class MyMetaObjectHandler implements MetaObjectHandler {  
    @Override  
    public void insertFill(MetaObject metaObject) {  
        this.setFieldValByName("createTime", new Date(), metaObject);  
    }  
}

（3）业务层CRUD

@Service  
public class UserService {  
    @Autowired  
    private UserMapper userMapper;  

    public void addUser(User user) {  
        userMapper.insert(user);  // 自动填充createTime  
    }  

    public List<User> findUsers(String keyword) {  
        QueryWrapper<User> wrapper = new QueryWrapper<>();  
        wrapper.like("name", keyword).ge("age", 18);  
        return userMapper.selectList(wrapper);  
    }  
}

五、依赖使用中的常见问题与解决方案

1. 依赖冲突问题

当项目同时引入Spring Boot和MyBatis-Plus时，可能出现版本冲突。可通过以下方式解决：

<!-- 排除MyBatis的自动依赖 -->  
<dependency>  
  <groupId>com.baomidou</groupId>  
  <artifactId>mybatis-plus-boot-starter</artifactId>  
  <exclusions>  
    <exclusion>  
      <groupId>org.apache.ibatis</groupId>  
      <artifactId>mybatis</artifactId>  
    </exclusion>  
  </exclusions>  
</dependency>

2. 主键生成策略失效

若自动生成主键失败，需检查：

  • 实体类字段类型是否为Long或Integer
  • 配置文件是否设置id-type: auto
  • 数据库表是否配置了自增主键

3. 分页查询结果不正确

确保：

  • 已正确配置分页拦截器
  • 使用Page对象接收分页结果：
IPage<User> page = new Page<>(1, 10);  
userMapper.selectPage(page, wrapper);

结论

通过本文的解析，我们看到mybatisplus依赖不仅是技术实现的基础，更是开发效率提升的关键。从依赖模块的组合选择，到核心接口的使用技巧，再到性能优化的配置方案，每一环节都体现了MyBatis-Plus对开发者体验的极致追求。对于初学者，建议从基础依赖开始，逐步尝试扩展功能；中级开发者则可通过分析源码，深入理解依赖模块的设计思想，从而在复杂项目中发挥其最大价值。

掌握MyBatis-Plus的依赖体系，就如同获得了“数据库操作的瑞士军刀”，它将帮助开发者在Java后端开发中，以更优雅的方式应对业务挑战。

最新发布

查看更多文章