MyBatis insert后返回自增字段的值

本文介绍如何在MyBatis中使用自增ID并将其返回到对象中。通过配置XML文件中的useGeneratedKeys和keyProperty属性实现。同时提供解决常见错误的方法。

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

如下情况适用支持自增的DB,如MySQL。其他情况参见:MyBatis魔法堂:Insert操作详解(返回主键、批量插入)

1.model

public class UserInfo {
    private int id;//主键自增ID
    private String userName;//姓名
    private String account;//登陆账号
    private String password;//密码
}

  

2.UserInfoMapper.java

public interface UserInfoMapper {
     int addUser(UserInfo userInfo);
}

  

3.UserInfoMapper.xml

<insert id="addUser" parameterType="com.xxx.model.UserInfo" useGeneratedKeys="true" keyProperty="id">
	INSERT INTO
	user_info(user_name, account, password)
	values
	(#{userName},#{account},#{password})
</insert>

  

这样,在插入后,MySQL自增的id就会设置到原来的userInfo对象里。

其中 useGeneratedKeys="true" keyProperty="id" 是起作用的关键语句。

4.QA

4.1 报错:org.apache.ibatis.binding.BindingException: Parameter 'id' not found

完整错误如下:

org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.executor.ExecutorException: Error getting generated key or setting result to parameter object. Cause: org.apache.ibatis.binding.BindingException: Parameter 'id' not found. Available parameters are [userInfo, param1]

这是因为在addUser()的对象参数前加@Param("userInfo"),而在mapper.xml里写成

<insert id="addUser" parameterType="com.xxx.model.UserInfo" useGeneratedKeys="true" keyProperty="id">
	INSERT INTO
	user_info(user_name,, account, password)
	values
	(#{userinfo.userName},#{userInfo.account},#{userInfo.password})
</insert>

这种情况在不返回自增值是没有问题的,但一旦设置了useGeneratedKeys就报错。所以养成良好的习惯,没事少加@Param!!!

 

 

end

转载于:https://www.cnblogs.com/waterystone/p/5654300.html

### 可能的原因分析 在使用 MyBatis 执行 `INSERT` 操作并尝试返回主键时,如果发现数据未成功插入,可能涉及以下几个方面的问题: #### 1. **SQL 配置错误** MyBatis 的配置文件中需要正确设置 `useGeneratedKeys="true"` 和 `keyProperty` 属性来支持自动获取自主键[^2]。如果没有正确配置这些属性,则可能导致虽然方法返回了主键,但实际上并未执行真正的插入操作。 ```xml <insert id="insertUser" useGeneratedKeys="true" keyProperty="id"> INSERT INTO users (name, age) VALUES (#{name}, #{age}) </insert> ``` #### 2. **事务管理问题** 如果当前环境启用了事务机制,而该事务未被提交或回滚,则可能会导致数据看似未插入的情况。即使 MyBatis 成功执行了 `INSERT` 并返回了主键,在事务未完成之前,数据不会持久化到数据库中[^3]。 #### 3. **数据库引擎限制** 某些数据库存储引擎(如 MySQL 中的 InnoDB 支持事务,而 MyISAM 不支持),如果不小心选择了不支持事务的存储引擎,可能会引发异常行为。例如,InnoDB 是默认推荐使用的存储引擎,但如果表使用的是 MyISAM,则可能出现无法正常插入数据的现象[^1]。 --- ### 解决方案 针对以上提到的各种可能性,可以采取以下措施解决问题: #### 方案一:检查 SQL 映射文件中的配置 确认 `<insert>` 节点是否设置了 `useGeneratedKeys="true"` 和指定了正确的 `keyProperty` 。以下是标准写法示例: ```xml <insert id="insertStorehouse" parameterType="com.example.Storehouse" useGeneratedKeys="true" keyProperty="storehouseId"> INSERT INTO storehouses (name, location) VALUES (#{name}, #{location}) </insert> ``` 此配置会告诉 MyBatis 自动填充对象对应的字段(由 `keyProperty` 定义)为主键。 #### 方案二:验证事务状态 确保调用 `insertReturnId()` 后手动或者通过框架完成了事务提交。如果是 Spring 管理的事务,可以通过如下方式开启声明式事务控制: ```java @Transactional(rollbackFor = Exception.class) public void saveWithTransaction() { Storehouse storehouse = new Storehouse(); storehouse.setName("New Warehouse"); storehouse.setLocation("Location A"); int rowsAffected = storehouseMapper.insertStorehouse(storehouse); } ``` 这里的关键在于 `@Transactional` 注解能够保证整个过程处于同一个事务上下文中,并且只有当没有抛出受检异常时才会提交事务[^3]。 #### 方案三:排查目标表的存储引擎类型 对于 MySQL 用户来说,务必核实所操作的数据表采用的是适合其业务逻辑需求的存储引擎。建议始终优先选用支持 ACID 特性的 InnoDB 引擎而非较老版本遗留下来的 MyISAM 引擎。 可通过运行下面这条命令查看现有表格的具体情况: ```sql SHOW TABLE STATUS WHERE Name='your_table_name'; ``` 假如显示的结果表明 Engine 列标注为 MYISAM ,则应考虑转换成 INNODB 。具体做法可参考官方文档说明链接。 --- ### 总结 综上所述,造成 MyBatis 插入记录失败却仍反馈主键的主要因素集中在三个方面——映射规则设定失误、缺少必要的事务处理以及底层物理结构设计不当之上。逐一排除这些问题之后即可恢复正常运作流程。 ---
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值