Mybatis批量插入index out of range错误怎么解决

# Mybatis批量插入index out of range错误怎么解决

## 问题现象

在使用MyBatis进行批量数据插入时，开发者可能会遇到以下错误：

java.lang.ArrayIndexOutOfBoundsException: Index X out of bounds for length Y

或

org.apache.ibatis.exceptions.PersistenceException: Error updating database. Cause: java.lang.ArrayIndexOutOfBoundsException

这种错误通常发生在执行批量插入操作时，特别是使用`<foreach>`标签处理集合参数的情况。

## 错误原因分析

### 1. JDBC参数限制
大多数数据库的JDBC驱动对单个SQL语句的参数数量有限制（如MySQL默认限制为65535），当批量插入数据量过大时，生成的SQL参数会超过这个限制。

### 2. MyBatis foreach分片问题
MyBatis的`<foreach>`标签在动态生成SQL时，如果集合元素过多，可能导致生成的SQL语句异常。

### 3. 数据类型不匹配
当传入的List中包含null元素或类型不一致时，可能导致参数映射错误。

## 解决方案

### 方案一：分批处理（推荐）

```java
// 每批插入1000条
int batchSize = 1000;
for (int i = 0; i < list.size(); i += batchSize) {
    List<Item> subList = list.subList(i, Math.min(i + batchSize, list.size()));
    mapper.batchInsert(subList);
}

对应Mapper XML配置：

<insert id="batchInsert">
    INSERT INTO table_name (col1, col2)
    VALUES 
    <foreach collection="list" item="item" separator=",">
        (#{item.prop1}, #{item.prop2})
    </foreach>
</insert>

方案二：调整JDBC参数限制

在数据库连接URL中添加参数（MySQL示例）：

jdbc:mysql://localhost:3306/db?rewriteBatchedStatements=true&allowMultiQueries=true

方案三：使用ExecutorType.BATCH模式

SqlSession sqlSession = sqlSessionFactory.openSession(ExecutorType.BATCH);
try {
    Mapper mapper = sqlSession.getMapper(Mapper.class);
    for (Item item : list) {
        mapper.insert(item);
    }
    sqlSession.commit();
} finally {
    sqlSession.close();
}

最佳实践建议

1. 合理设置批次大小：建议每批处理500-1000条记录
2. 监控SQL日志：开启MyBatis日志检查生成的SQL
3. 使用连接池：确保连接池配置足够支持批量操作
4. 事务管理：批量操作应在单个事务中完成

排查步骤

当遇到该错误时，建议按以下步骤排查： 1. 检查传入的集合参数是否为null或空 2. 打印或日志记录实际生成的SQL语句 3. 计算SQL中的参数数量是否超出限制 4. 逐步减少批量大小测试临界值

总结

MyBatis批量插入时的数组越界问题通常由SQL参数过多引起，通过分批处理、调整JDBC参数或使用BATCH执行模式可以有效解决。建议在开发阶段就对大数据量插入进行压力测试，选择合适的批次大小以获得最佳性能。

注意：不同数据库（Oracle/MySQL/PostgreSQL等）对批量插入的支持和限制有所不同，实际开发中应参考具体数据库文档。 “`