MyBatis-Plus插入后未返回主键ID解决方案

最新推荐文章于 2025-09-23 12:06:11 发布

原创最新推荐文章于 2025-09-23 12:06:11 发布 · 4.4k 阅读

1 ·

CC 4.0 BY-SA版权

文章标签：

#mybatis #java #开发语言

使用Mybatis-Plus如果需要insert后返回主键ID，只需在实体类ID属性上加以下注解

@TableId(value = "id", type = IdType.AUTO)
private Integer id;

我遇到的问题：
注解加上后ID并没有正常返回。

使用Mybatis-Plus需要注意：

当调用insert方法时，首先会去找mapper中是否已经存在insert方法，如果存在则调用，不存在则会调用BaseMapper中的insert方法。

我遇到的便是这种情况，由于mapper中我已经自定义了一个insert方法，并且xml中并没有定义

useGeneratedKeys="true" keyProperty="id"
所以实际调用的是自定义的insert方法。

解决方案：
①在自定义insert方法的xml中加上useGeneratedKeys="true" keyProperty="id"

②删除自定义的insert方法，并且在实体类的id主键上加上注解：

@TableId(value = "id", type = IdType.AUTO)

确定要放弃本次机会？

福利倒计时

: :

立减 ¥

普通VIP年卡可用

立即使用

Localtrant

关注关注

6
点赞
踩
1

收藏

觉得还不错? 一键收藏
0
评论
分享

复制链接

分享到 QQ

分享到新浪微博

扫一扫
举报

举报

mybatis-plus id主键生成的坑

09-07

本文将详细探讨 MyBatis-Plus 中主键生成所遇到的问题、错误原因及相应的解决方案。首先，MyBatis-Plus 默认的主键生成策略是 `IdType.AUTO`，这意味着它会尝试根据数据库的自增特性来生成主键。然而，当主键类型...

关于mybatis（insert插入）返回主键的问题

Nicholas_long的博客

12-27

2313

近来使用ssm框架中的mybatis遇到返回主键的问题，在使用mybatis的过程中遇到各种问题，在此发帖持续更新，在此发帖的原因一来是是为了方便以后回顾，二来是为了给遇到同样问题的同学们一个提示，废话不多说了开始正题。首先来看一下控制台提示的错误信息：错误一: Caused by: org.apache.ibatis.executor.ExecutorException: Err

参与评论您还未登录，请先登录后发表或查看评论

MyBatis-Plus插入数据后如何返回主键

理论都是虚的，代码才是王道。

01-03

3891

本文介绍了使用MyBatis-Plus插入数据后如何返回主键的步骤和相关代码片段。通过使用Mapper接口或MyBatis-Plus的ServiceImpl，我们可以方便地获取插入后生成的主键值。希望本文对你在使用MyBatis-Plus进行数据操作时有所帮助。

MyBatis-Plus主键回填失效？3个致命坑与终极避坑指南

热门推荐

dl348的博客

08-22

3万+

项目使用springboot搭建。最初的时候是使用mybatis，后来升级到mybatis plus。按照mp的官网介绍，使用mp的insert方法，对于自增的数据库表，mp会把主键写入回实例的对应属性。但实际操作起来，却没有主键。 entity 类设置如下： @TableName(value = "USERINFO") public class UserInfo { /** ...

【SpringBoot】91、SpringBoot解决Mybatis-Plus生成雪花ID重复问题

Asurplus

12-21

3万+

只要 workerId 和 dataCenterId 不同时重复，生成的雪花 ID 就不会重复。这是因为每个 ID 都是唯一的，并且是根据特定的算法生成的

分布式微服务架构下Mybatis plus 的save或insert方法不返回主键id

weixin_46463341的博客

10-08

4640

分布式微服务架构下Mybatis plus 的save或insert方法不返回主键id

关于Spring 整合 Mybatis 后，insert操作不返回ID的问题

03-26

320

搜索引擎关于这个问题找了很多，大部分给出的解释就是： [code="xml"] select LAST_INSERT_ID() [/code] 可是我在实际使用中，在service层做了注解型配置事务，当一个事务未执行完，select LAST_INSERT_ID() 这行SQL当做单独一个原子操作，不会立即执行。会等到insert操作完毕后，才会执行。接着我开始排查...

Mybatis批量插入返回插入主键失败的原因

weixin_43059252的博客

08-16

1208

通常批量插入返回主键按照如下方式配置即可 <insert id="insertBatch" keyProperty="id" useGeneratedKeys="true"> 批量插入报错且失败返回主键的原因主要是mybatis版本问题，亲测mybatis-3.4.2版本不行，但是mybatis-3.5.5版本可以 ...

Mybatis-Plus插入后返回元素ID

sunnyday0426的博客

06-19

1万+

Mybatis-Plus提供了多种方法来在插入数据后获取数据库自增的ID。除了使用@TableId注解外，还可以使用Mybatis-Plus提供的Wrapper类或使用原生SQL查询。

Mybatis 在 insert 插入操作后如何返回主键 id

z1ztai的博客

03-29

4544

JDBC 提供了一个 getGeneratedKeys 方法，用于获取插入记录的主键 ID。在 MyBatis 中，我们可以通过设置 useGeneratedKeys 和 keyProperty 属性来使用该方法。useGeneratedKeys 属性的作用是告诉 MyBatis 使用 JDBC 的 getGeneratedKeys 方法获取插入记录的主键 ID。在配置文件中，我们可以在 insert 元素中设置 useGeneratedKeys 属性： 2. 设置 keyProperty 属性 keyPr

MyBatisPlus新增返回主键ID

qq_38572916的博客

05-20

1526

【代码】MyBatisPlus新增返回主键ID。

MyBatis insert 返回主键的方法

liufeng520的专栏

02-08

7054

表结构： /*==============================================================*/ /* Table: Dic_City */ /*=====================================================

mybatis-plus baseMapper.insert 返回主键

09-18

<think> 我们正在讨论MyBatis-Plus的BaseMapper.insert方法如何返回主键的问题。根据提供的引用，我们可以总结出以下关键点： 1. 引用[3]和[5]明确指出，使用BaseMapper.insert方法插入数据后，会自动将生成的主键值填充到插入对象的对应字段中。因此，我们不需要从insert方法的返回值中获取主键，而是直接从传入的实体对象中获取。 2. 引用[5]提供了具体的代码示例：在实体类中，使用`@TableId`注解标识主键字段，并指定类型为`IdType.AUTO`（表示数据库自增）。插入后，通过实体对象的getId()方法即可获得自增主键。因此，解决方案包括两个步骤： - 在实体类中正确配置主键字段（使用`@TableId`注解，并指定自增类型）。 - 调用insert方法后，从传入的实体对象中获取主键值。下面给出详细说明和代码示例。 </think> ### MyBatis-Plus BaseMapper.insert 方法返回主键的实现方法在 MyBatis-Plus 中，`BaseMapper.insert()` 方法执行插入操作后，**不会直接返回主键值**（该方法返回值为 int 类型，表示受影响的行数）。但可以通过以下两种方式获取自增主键： #### ✅ 正确实现方式（推荐） 1. **实体类配置主键策略** 在实体类的主键字段添加 `@TableId` 注解并指定 `IdType.AUTO`： ```java @TableName("your_table") public class YourEntity { @TableId(value = "id", type = IdType.AUTO) // 关键配置 private Long id; // 对应数据库自增字段 // 其他字段... } ``` 2. **插入后直接获取主键** 插入操作完成后，主键值会自动回填到实体对象中： ```java YourEntity entity = new YourEntity(); entity.setName("test"); baseMapper.insert(entity); // 执行插入 // 直接从实体对象获取主键 Long generatedId = entity.getId(); // ✅ 获取自增主键 ``` #### ️ 注意要点 1. **无需设置主键值** 执行插入前**不要**手动设置主键值（如 `entity.setId(123L)`），否则会破坏自增逻辑[^3][^5]。 2. **主键类型需匹配** 数据库主键字段必须是自增类型（如 MySQL 的 `AUTO_INCREMENT`），且代码中的 `@TableId` 配置必须正确[^5]。 3. **常见错误排查** - ❌ 错误：尝试获取 `insert()` 返回值作为主键 ```java int result = baseMapper.insert(entity); Long id = (long) result; // ❌ 返回值是影响行数（通常为1），非主键 ``` - ❌ 错误：未配置 `@TableId` 注解或配置错误类型 --- ### 实现原理说明 MyBatis-Plus 通过以下机制实现主键回填： 1. 执行 SQL 后捕获 `Statement.getGeneratedKeys()` 返回的主键 2. 利用反射将主键值注入到实体类的 `@TableId` 标记字段 3. 整个过程在 `insert()` 方法内部自动完成[^2][^5] --- ### 多表插入场景扩展如需插入关联表数据并获取主键，可通过事务将操作封装： ```java @Transactional public Long createEntityWithDetail(Entity entity, Detail detail) { baseMapper.insert(entity); // 插入主表 Long mainId = entity.getId(); // 获取主表ID detail.setMainId(mainId); // 设置关联ID detailMapper.insert(detail); // 插入明细表 return mainId; // 返回主表ID } ```