深入分析Mybatis 使用useGeneratedKeys获取自增主键

最新推荐文章于 2025-04-11 15:34:33 发布

方丈的寺院

最新推荐文章于 2025-04-11 15:34:33 发布

阅读量2.5k

点赞数 5

分类专栏： java web 知识汇总 mysql 文章标签： mybatis on duplicate key getGeneratedKeys useGenerateKeys 批量插入自增主键

本文链接：https://blog.csdn.net/FS1360472174/article/details/100596334

版权

本文深入分析了在Mybatis中如何使用useGeneratedKeys获取自增主键，尤其是在批量插入和on duplicate key更新操作时可能出现的问题。通过探讨JDBC规范和Mybatis的实现，揭示了批量insert时如何正确获取自增ID，而批量insertOrUpdate由于影响行数的特殊性，可能导致获取的自增ID错误。最后，总结了批量操作的最佳实践。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

摘要

我们经常使用useGenerateKeys来返回自增主键，避免多一次查询。也会经常使用on duplicate key update，来进行insertOrUpdate，来避免先query 在insert/update。用起来很爽，但是经常踩坑，还不知为何。本篇就是深入分析获取自增主键的原理。

问题

首先摘两段我司一些老代码的bug

批量插入用户收藏

for (tries = 0; tries < MAX_RETRY; tries++) {
    final int result = collectionMapper.insertCollections(collections);
    if (result == collections.size()) {
        break;
    }
}
if (tries == MAX_RETRY) {
    throw new RuntimeSqlException("Insert collections error");
}
// 依赖数据库生成的collectionid
return collections;

collectionMapper.insertCollections 方法

<insert id="insertCollections" parameterType="list" useGeneratedKeys="true"
        keyProperty="collectionId">
    INSERT INTO collection(
    userid, item
    )
    VALUES
    <foreach collection="list" item="collection" separator=",">
        (#{collection.userId}, #{collection.item})
    </foreach>
    ON DUPLICATE KEY UPDATE
    status = 0
</insert>

不知道大家能不能发现其中的问题

分析

问题有两个

返回值result的判断错误

使用on duplicate key 批量update返回影响的行数是和插入的数不一样的。犯这种错主要在于想当然，不看文档
看下官网文档
写的很清楚

With ON DUPLICATE KEY UPDATE, the affected-rows value per row is 1 if the row is inserted as a new row, 2 if an existing row is updated, and 0 if an existing row is set to its current values. If you specify