MyBatis-Plus 中 BaseMapper 的常见误用及解决方案

目录

MyBatis-Plus 中 BaseMapper 的常见误用及解决方案

一、BaseMapper 的基本介绍

BaseMapper 常用方法

二、常见误用及解决方案

1. Mapper 接口未正确继承 BaseMapper

错误示例：

正确示例：

说明：

2. 在接口中重复实现 BaseMapper 的方法

错误示例：

正确示例：

说明：

3. SQL 映射与方法签名不匹配

错误示例：

正确示例：

说明：

4. 未正确配置 @Mapper 注解

错误示例：

正确示例：

说明：

5. SQL 映射语句存在错误

错误示例：

正确示例：

说明：

三、总结

在 Java 开发中，MyBatis-Plus 是一个非常流行的 ORM 框架，它通过封装常见的数据库操作，极大地提高了开发效率。然而，在实际开发中，开发者可能会遇到在自定义 Mapper 接口中使用 MyBatis-Plus 的 BaseMapper 时，方法不生效或返回错误的情况。本文将深入探讨这个问题，分析其原因，并提供具体的解决方案。

一、BaseMapper 的基本介绍

MyBatis-Plus 提供了一个 BaseMapper 接口，内置了一些常用的数据库操作方法，如增、删、改、查等。这些方法对大部分应用场景都适用，可以减少我们编写重复代码的工作。

BaseMapper 常用方法

以下是 BaseMapper 中提供的常用方法：

insert(T entity)：插入一条记录。

updateById(T entity)：根据 ID 更新记录。

deleteById(Serializable id)：根据 ID 删除记录。

selectById(Serializable id)：根据 ID 查询记录。

selectList(Wrapper queryWrapper)：查询列表，支持条件构造器。

selectPage(Page page, Wrapper queryWrapper)：分页查询。

这些方法大部分是通过注解和动态 SQL 实现的，通常不需要我们去写 SQL 语句，直接使用就能完成常见的数据库操作。

二、常见误用及解决方案

1. Mapper 接口未正确继承 BaseMapper

在使用 MyBatis-Plus 时，必须保证自定义的 Mapper 接口继承了 BaseMapper，否则 MyBatis-Plus 提供的基本方法无法生效。

错误示例：

public interface UserMapper {

// 没有继承 BaseMapper，导致 BaseMapper 中的通用方法无法使用

void insertUser(User user);

void updateUser(User user);

}

正确示例：

import com.baomidou.mybatisplus.core.mapper.BaseMapper;

@Mapper // 必须加 @Mapper 注解以让 MyBatis 扫描到

public interface UserMapper extends BaseMapper {

// 继承 BaseMapper 后，不需要重写增删改查的方法

}

说明：

确保你的自定义 Mapper 接口继承了 BaseMapper，并且标注了 @Mapper 注解。这样，MyBatis-Plus 会自动生成实现类，提供通用的增、删、改、查方法。如果没有继承 BaseMapper，这些方法将无法生效。