MyBatis insert foreach常见问题：如何正确使用foreach实现批量插入？

Question

在使用 MyBatis 进行批量插入时，常见的问题是 `foreach` 标签的用法不正确导致 SQL 语法错误或性能低下。如何正确使用 `foreach` 实现高效的批量插入？

Answer 1

一、MyBatis 批量插入中 foreach 的常见问题与使用误区

在 MyBatis 中，<foreach> 标签是实现批量操作的核心工具之一。但在实际开发中，由于对 SQL 语法和数据库行为理解不深，开发者常会遇到以下问题：

• SQL 拼接错误：未正确使用 open, separator, close 属性导致生成的 SQL 不合法。
• 性能低下：一次性插入大量数据导致数据库压力骤增或事务执行时间过长。
• 字段顺序错乱：误将多个对象属性拼接到错误的位置。
• 数据库兼容性问题：不同数据库对批量插入的支持方式不同（如 MySQL 支持 INSERT INTO ... VALUES (...), (...)，而 Oracle 则需要使用 FORALL）。

这些问题往往会导致系统在高并发场景下出现瓶颈，甚至引发线上故障。

二、foreach 标签的基本结构与用法解析

<foreach> 是 MyBatis 提供的一个迭代标签，用于遍历集合或数组，并根据配置进行 SQL 拼接。其基本结构如下：

<insert id="batchInsert">
  INSERT INTO user (name, age)
  VALUES
  <foreach collection="list" item="user" separator=",">
    (#{user.name}, #{user.age})
  </foreach>
</insert>
  

其中关键属性说明如下：

属性名	作用
collection	指定要遍历的数据源，可以是 list、array 或 map 中的 key
item	每次迭代时的元素变量名
separator	每次迭代之间的分隔符
open	循环开始前添加的内容
close	循环结束后添加的内容

该结构适用于 MySQL 等支持多值插入的数据库，但若数据量过大，仍需进一步优化。

三、foreach 性能瓶颈分析与解决方案

虽然 <foreach> 可以完成批量插入操作，但如果插入记录数非常大（例如上万条），可能会导致如下性能问题：

1. 单次 SQL 过长：超过数据库允许的最大包大小限制（如 MySQL 的 max_allowed_packet）。
2. 事务过大：一个事务提交的数据过多，影响数据库响应速度。
3. 内存占用过高：MyBatis 构建 SQL 字符串时消耗较多内存。

为解决这些问题，建议采用以下策略：

• 分批处理：将大批量数据拆分为多个小批次插入。
• 使用 JDBC 批处理：通过 addBatch() 和 executeBatch() 实现更高效的批量操作。
• 结合数据库特性：如使用 MySQL 的 LOAD DATA INFILE 或 PostgreSQL 的 COPY 命令。

示例：分页式批量插入代码逻辑：

public void batchInsert(List users, int batchSize) {
    SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH);
    try {
        UserMapper mapper = sqlSession.getMapper(UserMapper.class);
        for (int i = 0; i < users.size(); i++) {
            mapper.insertUser(users.get(i));
            if (i % batchSize == 0 || i == users.size() - 1) {
                sqlSession.commit();
            }
        }
    } finally {
        sqlSession.close();
    }
}
  

这种方式避免了构建超长 SQL，也降低了事务负担。

四、高级技巧与最佳实践

除了基础的 <foreach> 使用之外，还可以结合以下技术提升效率与稳定性：

• 动态 SQL 条件判断：配合 <if>、<choose> 等标签构建更灵活的插入语句。
• 自动生成主键：确保每条记录的唯一性和完整性。
• 日志监控与异常处理：记录每次插入的耗时与数量，便于后期排查。
• 数据库连接池优化：适当调大连接池大小以应对高并发批量写入。

流程图展示批量插入的推荐执行路径：

graph TD
    A[开始] --> B{是否启用批处理?}
    B -- 否 --> C[普通 foreach 插入]
    B -- 是 --> D[分批处理 + ExecutorType.BATCH]
    D --> E[每次插入后提交事务]
    E --> F[关闭会话]
    C --> G[提交事务]
    G --> H[结束]
    F --> H
    

这种设计兼顾了性能与稳定性，适用于大多数生产环境。