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`"),使用``指定表名即可

相关推荐
i***48618 分钟前
微服务生态组件之Spring Cloud LoadBalancer详解和源码分析
java·spring cloud·微服务
zzlyx999 分钟前
用C#采用Avalonia+Mapsui在离线地图上插入图片画信号扩散图
java·开发语言·c#
Aevget13 分钟前
MyEclipse全新发布v2025.2——AI + Java 24 +更快的调试
java·ide·人工智能·eclipse·myeclipse
一 乐31 分钟前
购物|明星周边商城|基于springboot的明星周边商城系统设计与实现(源码+数据库+文档)
java·数据库·spring boot·后端·spring
笃行客从不躺平36 分钟前
线程池监控是什么
java·开发语言
q***046339 分钟前
Linux环境下Tomcat的安装与配置详细指南
linux·运维·tomcat
y1y1z40 分钟前
Spring框架教程
java·后端·spring
q***51891 小时前
Spring Boot中Tomcat配置
spring boot·tomcat·firefox
曾经的三心草1 小时前
基于正倒排索引的Java文档搜索引擎3-实现Index类-实现搜索模块-实现DocSearcher类
java·python·搜索引擎
A***F1571 小时前
SpringBoot(整合MyBatis + MyBatis-Plus + MyBatisX插件使用)
spring boot·tomcat·mybatis