MyBatis 怎么在插入时获取自增主键 ID 值

轻瑶君_1165

轻瑶君_1165

2026-08-09

615人浏览

原创

mybatis插入后获取自增id的核心是通过usegeneratedkeys+keyproperty将数据库生成的id自动回填到java对象属性中,而非返回值;需数据库主键自增且jdbc驱动支持getgeneratedkeys(),实体类须有对应getter/setter。

mybatis 怎么在插入时获取自增主键 id 值

MyBatis 在插入数据后获取自增主键 ID,核心是让框架把数据库生成的 ID 自动回填到 Java 对象里,而不是靠额外查一次数据库。关键在于配置方式和数据库支持,不是所有场景都适用同一种写法。

useGeneratedKeys + keyProperty(推荐,MySQL/PostgreSQL 等常用)

这是最简洁、性能最好的方式,依赖 JDBC 的 getGeneratedKeys() 方法,无需额外 SQL 查询。

  • 前提条件:数据库表主键必须设为自增(如 MySQL 的 AUTO_INCREMENT),且 JDBC 驱动支持该特性
  • XML 写法<insert id="insertUser" usegeneratedkeys="true" keyproperty="id">INSERT INTO user(name) VALUES(#{name})</insert>
  • 注解写法@Insert("INSERT INTO user(name) VALUES(#{name})")@Options(useGeneratedKeys = true, keyProperty = "id")
  • 注意点:Java 实体类中必须有 id 字段的 getter/setter;插入后直接读取对象的 id 属性即可,方法本身无返回值

selectKey(通用性强,适配 Oracle 等不支持 getGeneratedKeys 的库)

通过显式 SQL 获取刚插入的主键,灵活性高,但多一次查询,高并发下需注意 LAST_INSERT_ID()@@identity 的会话隔离性。

Java Development Manual
Java Development Manual

Java开发手册规约集合,基于阿里巴巴Java开发手册(嵩山版)。 涵盖7大维度:编程规约、异常日志、单元测试、安全规约、MySQL数据库、工程结构、设计规约。 当用户需要:(1) 编写或审查Java代码 (2) 检查命名/代码规范 (3) 处理异常和日志 (4) 编写单元测试 (5) 安全编码 (6) 数据库设...

下载
  • order="AFTER":先插入,再执行 SELECT LAST_INSERT_ID()(MySQL)或 SELECT @@identity(SQL Server)
  • order="BEFORE":适用于序列(如 Oracle),先查序列值赋给对象,再插入(此时 SQL 中要引用该值)
  • 示例<selectkey keyproperty="id" resulttype="long" order="AFTER">SELECT LAST_INSERT_ID()</selectkey>
  • 适用场景:跨数据库兼容、需要控制主键生成逻辑、或底层驱动不支持 useGeneratedKeys

批量插入时怎么拿 ID?

MyBatis 支持批量插入并回填主键,但只对 useGeneratedKeys=true 有效,selectKey 不支持批量。

  • 传入 List<user></user>,Mapper 接口方法仍为 void insertBatch(List<user> list)</user>
  • XML 中保持 useGeneratedKeys="true" keyProperty="id",MyBatis 会逐条设置每条记录的 id
  • MySQL 5.7+ 和较新 JDBC 驱动下表现稳定;旧版本可能只返回第一条的 ID,需验证

常见踩坑提醒

看似简单,但实际容易出错的地方集中在配置和环境匹配上。

  • 实体类字段名与 keyProperty 不一致(比如字段叫 userId 却写成 id
  • 数据库没开自增,却用了 useGeneratedKeys —— 结果是 id 仍为 0 或 null
  • MySQL 使用 InnoDB 引擎但事务未提交,LAST_INSERT_ID() 在不同连接间不可见
  • 多数据源或分库场景下,selectKey 可能指向错误的数据源,useGeneratedKeys 更可靠

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
mybatis一级缓存和二级缓存
mybatis一级缓存和二级缓存

在MyBatis中,一级缓存和二级缓存是两种不同级别的缓存机制,它们都可以用来提高性能。本专题提供mybatis一级缓存和二级缓存相关文章,大家可以免费阅读。

2023.08.21

563

4

ibatis和mybatis有什么区别
ibatis和mybatis有什么区别

ibatis和mybatis的区别:1、基本信息不同;2、开发时间不同;3、功能与易用性;4、配置文件;5、入参类型与出参类型;6、返回结果集接受方式;7、语法差异;8、数据库方言支持;9、插件支持;10、社区活跃度;11、全球化支持。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

1902

5

mybatis如何配置数据库连接
mybatis如何配置数据库连接

mybatis配置数据库连接的方法:1、指定数据源;2、配置事务管理器;3、配置类型处理器和映射器;4、使用环境元素;5、配置别名。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

446

5

mybatis工作原理及流程是什么
mybatis工作原理及流程是什么

mybatis工作原理及流程:1、配置文件;2、接口与映射;3、sql解析与生成;4、执行计划;5、结果处理;6、动态sql;7、缓存机制;8、插件;9、事务管理;10、日志与监控;11、扩展性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

272

4

hibernate和mybatis有哪些区别
hibernate和mybatis有哪些区别

hibernate和mybatis的区别:1、实现方式;2、性能;3、对象管理的对比;4、缓存机制。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

302

5

Java MyBatis框架
Java MyBatis框架

本专题专注于Java主流ORM框架MyBatis的应用,系统讲解SQL映射、动态SQL、结果映射、分页查询、缓存机制与多表关联等核心内容,并结合企业管理系统、电商平台和后台管理项目实战,帮助学员全面掌握高效的数据库持久层开发技能。

2025.08.26

4929

22

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

2026.09.20

20

13

AionClaw AI智能体与电脑自动化任务执行功能使用教程
AionClaw AI智能体与电脑自动化任务执行功能使用教程

AionClaw专题整理AI智能体与电脑自动化相关功能使用教程,涵盖安装部署、AI任务执行、Skills技能、文件处理、浏览器控制、电脑操作、持久记忆、聊天工具连接以及办公、编程和内容创作等功能,帮助用户快速掌握AionClaw的实际使用方法。

2026.09.20

0

15

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习