MYBATIS-PLUS入门使用、踩坑记录

转载:

mybatis-plus入门使用、踩坑记录 - 灰信网(软件开发博客聚合)

首先引入MYBATIS-PLUS依赖:

SPRING BOOT项目:

复制代码
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus-boot-starter</artifactId>
    <version>3.2.0</version>
</dependency>

SPRING MVC项目:

复制代码
<dependency>
    <groupId>com.baomidou</groupId>
    <artifactId>mybatis-plus</artifactId>
    <version>3.2.0</version>
</dependency>

配置:

SPRING BOOT 工程:

复制代码
@MapperScan("com.xxx.mapper")

SPRING MVC 工程:

  • 配置 MapperScan

    <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.baomidou.mybatisplus.samples.quickstart.mapper"/> </bean>
  • 调整 SqlSessionFactory 为 MyBatis-Plus 的 SqlSessionFactory

    <bean id="sqlSessionFactory" class="com.baomidou.mybatisplus.extension.spring.MybatisSqlSessionFactoryBean"> <property name="dataSource" ref="dataSource"/> </bean>

引入:EXTENDS BASEMAPPER<T>

还有扩展的server方法及实现,可以自己点进去看下

需要用到就对应service继承即可, 示例:

复制代码
public interface UserService extends BaseService<User> {
}
public class UserServiceImpl extends BaseServiceImpl<UserMapper, User> implements UserService {
}

坑一:出现 INVALID BOUND STATEMENT (NOT FOUND) 异常

  • 未去除原有mybatis-spring-boot-starter依赖,导致冲突
  • mapper文件夹未扫描到,加入@MapperScan

坑二:CAUSED BY: JAVA.SQL.SQLINTEGRITYCONSTRAINTVIOLATIONEXCEPTION: COLUMN 'XXX' CANNOT BE NULL

这个问题很明显是字段不能是空,必须使用selective方法进行插入。一开始怀疑mybatis-plus的插入语句(就只一个insert)是全量插入

后来查找mapper文件找到了问题所在。之前用的mybatis框架自动生成的mapper.xml代码中的insert语句为全量插入,本地写了同名的xml会优先使用本地的SQL进行查询。

解决:删除所有mybatis生成的SQL语句,避免与mybatis-plus的底层SQL冲突

坑三:主键随机自增,导致ID超范围问题 COULD NOT SET PROPERTY 'ID' OF 'CLASS COM.XXX.USER' WITH VALUE '1037678924715731598' CAUSE: JAVA.LANG.ILLEGALARGUMENTEXCEPTION: ARGUMENT TYPE MISMATCH

如果没有指定ID生成策略,mybatis-plus默认是使用自己随机的ID生成策略,会生成一个比较大的数,可能会大小溢出。

解决:在实体类ID字段上加上注解 @TableId(type = IdType.AUTO),使用数据库的自增策略。 如果自增主键很多都是id,可以写一个基础的BasePO,在这个类里面指定id的生成策略,其它表对应实体类继承即可,如下:

复制代码
public class BasePO {
 
    @TableId(type= IdType.AUTO)
    private Long id;
}

下面是IdType其它类型介绍

坑四:关键字冲突问题 CAUSE: JAVA.SQL.SQLSYNTAXERROREXCEPTION: YOU HAVE AN ERROR IN YOUR SQL SYNTAX; CHECK THE MANUAL THAT CORRESPONDS TO YOUR MYSQL SERVER VERSION FOR THE RIGHT SYNTAX TO USE NEAR 'ORDER WHERE ID=1

当你的数据库表名是order、group等之类的关键字时,对该表的操作则会报错.

解决:在表对应的实体上增加注解 @TableName("`order`"),使用``指定表名即可

相关推荐
Lei活在当下3 分钟前
先用起来,再理解,关于协程Coroutine应该知道的事
android·java·jvm
Java爱好狂.20 分钟前
Java程序员体系化学习路线(2026最新版)
java·后端·java面试·java架构师·java程序员·java八股文·java学习路线
tongluowan0071 小时前
以ReentrantLock为例解释AQS的工作流程
java·模板方法模式·aqs·reentrantlock
身如柳絮随风扬2 小时前
Java 项目打包与部署完全指南:JAR vs WAR,从构建到运行
java·firefox·jar
云烟成雨TD2 小时前
Spring AI Alibaba 1.x 系列【62】时光旅行(Time-Travel)
java·人工智能·spring
浩少7023 小时前
【无标题】
java·开发语言
一棵白菜3 小时前
java 学习
java
卷毛的技术笔记3 小时前
Java后端硬核实战:用Spring AI Alibaba+Redis给LLM装上“超强记忆中枢”
java·人工智能·redis·后端·spring·ai·系统架构
AKA__Zas4 小时前
初识多线程(3.0)
java·开发语言·学习方法
北漂人Java4 小时前
SpringAI-2.Spring AI整合本地模型和云端大模型
java·spring