MyBatis在insert插入对象时，返回自增主键失败

### 使用 MyBatis 进行批量插入并获取自增主键 为了实现通过 MyBatis 插入多条记录的同时获取每一条记录对应的自增主键 ID，需遵循特定配置与编码实践。 #### 环境准备 确保所使用的 MyBatis 版本不低于 3.3.1[^2]。较低版本可能不具备此功能的支持。 #### Mapper XML 文件配置 在 `mapper.xml` 中定义 SQL 映射语句时，应加入如下属性来启用自动生成的键值返回： ```xml <insert id="batchInsert" useGeneratedKeys="true" keyProperty="id"> INSERT INTO table_name (column_list) VALUES <foreach collectioncolumn2}) </foreach> </insert> ``` 上述代码片段展示了如何利用 `<foreach>` 标签遍历传入的对象集合，并为每一项构建相应的插入子句；同时设置了 `useGeneratedKeys=true` 及指定了用于接收新生成 ID 的对象属性名 `keyProperty="id"`。 #### Java 接口设计 对应于上面的映射文件，在接口层面上声明相应的方法签名，注意这里只接受单一参数即待插入的数据集数组或列表形式传递给 DAO 层处理: ```java public interface UserMapper { int batchInsert(@Param("list") List<User> userList); } ``` 值得注意的是，尽管执行批处理操作，但该方法仍然保持简单整数类型的返回值表示受影响行的数量而非直接返回包含所有新增 ID 的列表。 #### 实体类调整 如果表中的自动增长列名称与实体类成员变量命名存在差异，则应在 mapper xml 设置额外两个属性：`keyColumn` 和 `keyProperty` 来建立两者之间的关联关系。 例如对于 MySQL 表内名为 `user_id` 而实体类里叫作 `userId` 的情况可以这样指定： ```xml <insert id="batchInsertUserWithDifferentIdName" useGeneratedKeys="true" keyColumn="user_id" keyProperty="userId"> <!-- ... --> </insert> ``` #### 测试验证 最后编写单元测试案例调用上述服务完成实际业务逻辑检验整个流程是否正常工作以及确认确实能够取得预期的结果集——也就是各个被插入记录各自的唯一标识符。