当前位置:

首页 > 编程开发 > Springboot+MyBatis插入语句返回主键id的问题(插入后返回主键id不是期望的值)

Springboot+MyBatis插入语句返回主键id的问题(插入后返回主键id不是期望的值)

前言 在使用MyBatis进行数据插入时,经常会遇到一个困惑:明明数据库里插入了数据,自动生成的主键id也正确,但代码里返回的int值却是1(或者一串负数),而不是期望的id值。今天就来彻底梳理一下这个问题的根源和正确做法。 先看一个典型场景:用注解@Options(useGeneratedKeys

本文目录

    前言

    在使用MyBatis进行数据插入时,经常会遇到一个困惑:明明数据库里插入了数据,自动生成的主键id也正确,但代码里返回的int值却是1(或者一串负数),而不是期望的id值。今天就来彻底梳理一下这个问题的根源和正确做法。

    先看一个典型场景:用注解@Options(useGeneratedKeys = true, keyProperty = "id")配置了自动回填主键,但执行完插入后,返回的int id始终是1,检查数据库,数据确实插入成功,id也正确。这到底是怎么回事?

    下面分别用注解开发和XML映射两种方式演示,并给出正确的取值方式。

    业务代码片段(错误示范):

    Integer id = tblSchoolOrganizationInfoMapper.insertReturnId(info);
    id = info.getId();
    log.info("插入成功!id = {}", id);

    注解开发代码:

    @Mapper
    public interface TblSchoolOrganizationInfoMapper extends BaseMapper {
        @Insert("INSERT INTO TblSchoolOrganizationInfo(`createTime`, `isDeleted`, `updateTime`, `code`, `name`, `remarks`, `theOrder`, `childNum`, `isLeaf`, `parentId`, `theLevel`, `trainingScope`, `allNodesName`, `rootId`, `secondNodeId`, `account`) " +
                "VALUES(#{createtime},#{isdeleted},#{updatetime},#[code],#{name},#{remarks},#{theorder},#{childnum},#{isleaf},#{parentid},#{thelevel},#{trainingscope},#{allnodesname},#{rootid},#{secondnodeid},#{account})")
        @Options(useGeneratedKeys = true, keyProperty = "id")
        Integer insertReturnId(TblSchoolOrganizationInfo info);
    }
    

    XML映射形式:

    
    
        
            INSERT INTO TblSchoolOrganizationInfo
            (`createTime`, `isDeleted`, `updateTime`, `code`, `name`, `remarks`, `theOrder`, `childNum`, `isLeaf`, `parentId`, `theLevel`, `trainingScope`, `allNodesName`, `rootId`, `secondNodeId`, `account`)
            VALUES
                (#{createtime}, #{isdeleted}, #{updatetime}, #[code], #{name}, #{remarks}, #{theorder}, #{childnum}, #{isleaf}, #{parentid}, #{thelevel}, #{trainingscope}, #{allnodesname}, #{rootid}, #{secondnodeid}, #{account})
        
    

    注意事项

    1. 表的主键必须设置为自增(AUTO_INCREMENT),否则无法自动生成id。

    2. 无论使用注解还是XML,都必须显式声明useGeneratedKeys=true和keyProperty。注解用@Options,XML用。如果缺少这个配置,虽然插入成功,但返回的id可能是一串很大的负数,比如-759160831。

    3. 编写SQL时,不要在INSERT语句中手动为自增主键列赋值(即不写id字段),否则MyBatis无法正确回填主键,也可能导致id值异常。

    4. 最容易踩的坑:插入方法的返回值并不是你期望的id,而是数据库受影响的行数(int)。所以直接接收返回值得到的永远是1(或0)。但MyBatis会自动将生成的主键值设置到传入的参数对象中(通过keyProperty指定的属性)。因此正确的做法是:忽略返回值,直接通过参数对象获取id。

    实际应该是这样

    Integer row = tblSchoolOrganizationInfoMapper.insertReturnId(info);
    log.info("插入成功!影响的行数 row = {}", row);
    Integer id = info.getId();
    log.info("插入成功!id = {}", id);

    Springboot+MyBatis插入语句返回主键id的问题(插入后返回主键id不是期望的值)

    其实原理很简单:MyBatis在执行插入后,通过JDBC的getGeneratedKeys方法获取数据库生成的主键,然后通过反射设置到传入对象的指定属性中。返回值只是执行影响的记录数,与主键无关。

    总结

    以上经验可以帮助快速定位类似问题:先确认表自增配置和useGeneratedKeys声明,然后记住操作对象而非返回值。只要正确配置,通过info.getId()就能拿到期望的id值。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    LiteLLM 1.109.0迁移要改什么,1.108.5 LTS、1.106.8与1.110.0-rc.1该如何看
    LiteLLM 1.109.0迁移要改什么,1.108.5 LTS、1.106.8与1.110.0-rc.1该如何看

    给出LiteLLM1.109.0五项迁移配置,说明fallback列表、local缓存、router_settings硬限流、Gemini参数和Lens独立部署,并区分LTS/旧补丁/RC。

    agent-desktop 1.3.1升级后如何理解沙箱存活与桌面快照?
    agent-desktop 1.3.1升级后如何理解沙箱存活与桌面快照?

    agent-desktop 1.3.1让已经启动的沙箱在启动器退出后继续运行,并更新rustix至1.1.6。对通过JSON快照操作桌面的用户而言,沙箱存活、平台权限与ref有效性需要分别判断,不能用其中一项正常代替整项任务的验收。

    langchain-core 1.8.1如何理解langsmith_gateway的作用范围和优先级
    langchain-core 1.8.1如何理解langsmith_gateway的作用范围和优先级

    langchain-core 1.8.1新增的langsmith_gateway用于上下文级LangSmith Gateway覆盖。它并非一次模型调用的临时请求参数:路由在模型构造时解析,因而生效位置、集成支持和配置优先级都需要一起理解。

    Claude Trading Skills如何理解覆盖状态和密钥审查限制?
    Claude Trading Skills如何理解覆盖状态和密钥审查限制?

    Claude Trading Skills分别记录覆盖完整性、数据来源和规则确认;维护者自动扫描标记的not_verified不能等同完整安全验证或已发生密钥泄露,相关Skill代码未在该审查提交中修改。

    llama.cpp预发布b12420、b12424、b12426、b12428怎么按模型任务选择构建
    llama.cpp预发布b12420、b12424、b12426、b12428怎么按模型任务选择构建

    llama.cpp预发布b12420、b12424、b12426、b12428分别带来模型与模板层面的变化。文本模型、文本转语音、语音识别和Jinja渲染不是一项能力;按任务对应构建,可以避免把某个新增支持误认为适用于所有模型的通用升级。

    Google Ads Skills 1.1.1/1.0.3如何检查安装和账号诊断边界?
    Google Ads Skills 1.1.1/1.0.3如何检查安装和账号诊断边界?

    Google Ads设置与Quickstart Skills 1.1.1、账号诊断1.0.3明确MCP有限写入、只读配置和结构化search参数,安装前提为Python3.10+与pipx。

    LangChain四个集成包加入Gateway后,Python环境要注意什么
    LangChain四个集成包加入Gateway后,Python环境要注意什么

    LangChain四个模型集成包共同移除Python3.10支持并加入Gateway路由,需区分独立包版本与各自修复。

    WorkBuddy免费版能用吗?免费功能有哪些限制
    WorkBuddy免费版能用吗?免费功能有哪些限制

    WorkBuddy 免费版能用:体验版限时免费,每月 500 积分,限免期间享全模型调度、无限代码补全、99 个自动任务额度、每项目 5 人协作,另有 3 个自动任务、5 个项目、5GB 资料库、10 个云服务应用的数量限制。本文含官网定价页截图、积分消耗规律和免费补积分方法。

    Qwen Code 0.27.4如何理解临时授权、风险确认与消息分段
    Qwen Code 0.27.4如何理解临时授权、风险确认与消息分段

    解释Qwen Code 0.27.4临时目录授权、Managed Web Terminal、风险确认及飞书企业微信有序分段回复的边界。

    Claude Code 2.1.325哪些权限默认值变了,自动任务如何适配?
    Claude Code 2.1.325哪些权限默认值变了,自动任务如何适配?

    Claude Code 2.1.325改变了两类自动执行的默认行为:沙箱内Bash默认走常规权限流程,定时任务及/loop执行带allowed-tools或hooks声明的Skill会先请求确认。官方提供了对应配置,但受管环境必须遵守最高优先级的管理来源。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。