MyBatis批量插入数据与主键回写问题解析

背景介绍

在使用MyBatis进行数据库操作时，批量插入数据是一个常见的性能优化需求。特别是在处理大量数据时，如何高效地执行插入操作并正确获取生成的主键值，是开发者经常遇到的问题。

问题现象

在使用MyBatis 3.5.3与MySQL 8.0时，开发者尝试通过批量插入方式向ass_vehicle_brand表插入多条记录，并期望获取自动生成的主键ID。表结构设计为包含自增主键id和名称字段name。

错误分析

开发者最初尝试将批量插入与批处理执行器(BATCH executor)混合使用，导致系统抛出UnsupportedOperationException异常。这是因为MyBatis在处理主键回写时，对于批处理模式下的参数类型有特定要求。

解决方案

正确使用批量插入

MyBatis支持两种主要的批量数据插入方式：

1. 多行插入语法：使用SQL的多行VALUES语法一次性插入多条记录
2. 批处理执行器：通过JDBC的批处理功能批量执行单行插入语句

多行插入语法实现

<insert id="insertBrands" useGeneratedKeys="true" keyProperty="id">
  INSERT INTO ass_vehicle_brand (name)
  VALUES 
  <foreach collection="list" item="item" separator=",">
    (#{item.name})
  </foreach>
</insert>

这种方式适合一次性插入数据量不大的情况，能有效减少网络往返次数。

批处理执行器实现

// 配置使用批处理执行器
SqlSession session = sqlSessionFactory.openSession(ExecutorType.BATCH);
try {
  BrandMapper mapper = session.getMapper(BrandMapper.class);
  for (Brand brand : brands) {
    mapper.insertBrand(brand); // 单条插入语句
  }
  session.commit();
} finally {
  session.close();
}

批处理模式适合大量数据插入，但需要注意：

• 参数应该是单个实体对象而非集合
• 需要手动控制事务提交
• 建议合理设置批处理大小

MySQL性能优化建议

对于MySQL数据库，还可以通过以下配置进一步提升批量插入性能：

1. 在JDBC连接字符串中添加rewriteBatchedStatements=true参数
2. 根据数据量大小调整批处理批次大小
3. 考虑在批量操作期间暂时禁用索引和约束

技术原理

MyBatis的主键回写机制依赖于JDBC的getGeneratedKeys()方法。在多行插入场景下，MySQL会返回所有生成的主键值，MyBatis会按顺序将这些值赋给对应的参数对象。而在批处理模式下，MyBatis需要确保参数对象类型与主键属性匹配才能正确赋值。

最佳实践

1. 对于中小批量数据(几十到几百条)，推荐使用多行插入语法
2. 对于大批量数据(上千条)，推荐使用批处理执行器并合理分批次提交
3. 始终测试不同批量大小对性能的影响，找到最佳平衡点
4. 确保事务管理得当，避免长时间运行的大事务

通过理解MyBatis的批量操作机制和主键回写原理，开发者可以更高效地实现数据插入功能，同时保证系统的稳定性和性能。