<think>我们之前讨论过数组
越界的问题，现在具体到
MyBatis插入操作中出现的`
IndexOutOfBoundsException`。
根据错误信息：`Index 4 out of bounds for length 0`，说明在某个长度为0的地方尝试访问索引4。
在
MyBatis中，当我们使用`<foreach>`标签进行批量插入时，如果传入的List为空（size=0），但是在SQL语句中却引用了某个索引（比如参数列表的第四个参数），则可能引发此
异常。
具体分析：
1.
MyBatis在处理动态SQL时，特别是`<foreach>`标签，会遍历传入的集合（如List）。
2. 如果传入的List为空（size=0），则`<foreach>`内部的循环次数为0，不会生成任何插入语句。
3. 但是，如果我们的SQL语句中，除了`<foreach>`部分之外，还引用了其他参数，并且这些参数的索引位置因为List为空而发生变化，可能导致引用了一个不存在的参数索引。
另一种可能情况是：在SQL语句中使用了`#{param4}`这样的占位符，期望获取第四个参数，但实际上传入的参数不足四个。
然而，根据错误信息，长度是0，索引是4，说明参数列表是空的（长度为0），但我们却试图访问第5个参数（索引从0开始，索引4表示第五个参数）。这通常意味着参数绑定时的参数个数不足。
检查点：
1. 传入的List是否为空？但即使为空，也不应该直接出现索引4的
越界。
2. 检查Mapper接口方法的参数列表，以及XML中SQL语句的参数引用方式。
示例场景：
假设Mapper接口方法定义为：
int batchInsert(@Param("list") List<User> users, @Param("otherParam") String otherParam);
在XML中，可能会这样写：
<insert id="batchInsert">
INSERT INTO user (name, age) VALUES
<foreach collection="list" item="user" separator=",">
(#{user.name}, #{user.age})
</foreach>
, (#{otherParam}, ...) <!-- 这里可能引用了第二个参数 -->
</insert>
但是，如果传入的list为空，那么`<foreach>`不会生成任何语句，于是SQL变成了：
INSERT INTO user (name, age) VALUES , (?, ...) -- 注意这里有一个逗号，会导致语法错误，但这里不是重点。
然而，错误信息是
索引越界，而不是语法错误。所以更可能的情况是，在绑定参数时，由于list为空，整个参数列表可能发生了变化，导致访问第四个参数（索引4）时
越界。
另一种常见情况：在动态SQL中使用了`<if>`标签，并且条件依赖于集合的非空，但参数绑定可能仍然在引用某个不存在的参数。
解决方案：
1. 在调用Mapper方法之前，检查传入的List是否为空。如果为空，则不执行该插入操作。
2. 在
MyBatis的XML配置中，确保在引用参数之前进行非空判断，特别是对于集合参数。
例如，修改XML配置，当list为空时，不要执行插入：
<insert id="batchInsert">
<if test="list != null and list.size() > 0">
INSERT INTO user (name, age) VALUES
<foreach collection="list" item="user" separator=",">
(#{user.name}, #{user.age})
</foreach>
</if>
</insert>
但是，如果list为空，这个插入语句将不会执行任何SQL，这可能导致方法返回0（影响行数），而不是抛出
异常。
然而，错误是`
IndexOutOfBoundsException`，说明在解析SQL时发生了参数绑定错误。因此，重点检查参数传递的个数和SQL中引用的参数位置。
更可能的根本原因：
可能是方法的参数列表有多个参数，但实际传入时，只传了一个List（而方法需要多个参数）。例如：
@Insert("INSERT INTO user (id, name) VALUES (#{id}, #{name})")
int insertUser(@Param("id") Integer id, @Param("name") String name);
但是调用时传入的参数个数不足，或者传入了一个null，导致参数数组为空（长度为0），而SQL中需要两个参数（索引0和1），但如果有多个参数绑定，可能内部处理时索引计算错误。
由于错误信息是索引4，说明在绑定参数时，试图获取第五个参数（索引从0开始），而实际参数个数为0。
因此，需要检查：
- Mapper接口方法的参数个数和类型。
- 实际调用时传入的参数个数和类型。
示例：如果方法定义为：
void insertBatch(@Param("list") List<User> list, @Param("flag") int flag, @Param("type") String type, @Param("time") Date time, @Param("extra") Object extra);
这个方法需要5个参数。但是调用时，只传入了一个List，那么其他四个参数都没有传入，导致参数数组长度为1（但预期5个），那么当访问第五个参数（索引4）时，就会出现长度1的数组访问索引4，
越界。
但是错误信息是length 0，说明参数数组长度为0，而我们要访问索引4（即第五个参数），所以是调用时可能连第一个参数（那个List）都没有传入，而是传入了一个空数组（或者null？）。具体来说，可能是调用Mapper方法时，传递的参数个数不够，或者传递了null。
所以，解决方案：
1. 检查调用Mapper方法的代码，确保传递了所有必需的参数。
2. 检查Mapper方法的参数定义，确认参数个数和名称。
如果确实需要多个参数，并且传入的List为空，那么其他参数是否还需要？如果不需要，则可以在XML中通过条件判断来避免引用这些参数。
但是，由于错误发生在参数绑定阶段，所以根本原因还是调用时传入的参数个数不符合Mapper方法的参数个数。
因此，请确保调用Mapper方法时传入的参数个数和类型与接口定义一致。
示例代码：
// Mapper接口
public interface UserMapper {
void batchInsert(@Param("users") List<User> users, @Param("operator") String operator, @Param("time") Date time);
}
// 调用代码
List<User> userList = new ArrayList<>(); // 假设这里为空
String operator = "admin";
Date now = new Date();
// 正确调用：传入三个参数
userMapper.batchInsert(userList, operator, now);
如果调用时只传入了一个参数（userList），那么就会抛出参数个数不匹配的
异常，但具体
异常可能被包装成`
IndexOutOfBoundsException`。
在
MyBatis中，如果使用反射调用方法，参数个数不对，会抛出`Array
IndexOutOfBoundsException`。因为
MyBatis会将传入的参数放入一个数组，然后通过索引获取。如果参数个数不足，则访问索引就会
越界。
所以，请确保调用Mapper方法时传入的参数个数和方法定义的参数个数一致。
另外，如果使用了动态代理，
MyBatis会检查参数。但是，如果传入的参数中有一个是null，并且参数个数正确，那么不会抛出这个
异常。只有当参数数组长度小于预期个数时，才会出现。
总结步骤：
1. 检查Mapper接口方法的参数个数。
2. 检查调用Mapper方法时传入的参数个数。
3. 如果传入的List为空，但方法还有其他参数，仍然需要传入这些参数。
如果调用代码确认正确，则检查
MyBatis的XML配置中是否引用了不存在的参数（比如参数索引超过了实际个数）。
例如，在XML中使用了`#{param4}`，但是方法只有三个参数，那么第四个参数（索引3）就会
越界。注意：在
MyBatis中，参数绑定可以通过索引（从0开始）或通过@Param注解指定的名称。
使用名称引用可以避免索引问题。因此，建议在XML中始终使用@Param注解的参数名来引用参数，而不是使用`param1, param2`或者索引。
例如：
使用`#{operator}`而不是`#{1}`
这样，即使参数顺序变化，也不会导致问题。
因此，最终的解决步骤：
1. 检查调用Mapper方法时传入的参数个数是否与方法定义一致。
2. 在XML中，使用@Param注解的参数名来引用参数，避免使用索引方式（如`#{0}`、`#{1}`）。
3. 对于集合参数，在动态SQL中先判断非空。
如果问题仍然存在，请检查
MyBatis的日志，查看实际生成的SQL语句和参数绑定的情况。
示例修正代码：
假设原错误调用为：
userMapper.batchInsert(Collections.emptyList()); // 只传入一个参数，但方法需要三个
修正为：
userMapper.batchInsert(Collections.emptyList(), "admin", new Date());
或者，如果方法定义不需要那么多参数，修改方法定义。
如果确实是参数传递错误，修正传递的参数个数即可。
如果不确定，可以检查
MyBatis的日志（开启日志级别为DEBUG），查看绑定的参数列表。
开启
MyBatis日志的方法（在application.properties中）：
logging.level.org.
mybatis=DEBUG
或者在logback.xml中配置：
<logger name="org.
mybatis" level="DEBUG"/>
通过日志可以查看实际绑定的参数。
如果无法查看日志，可以在代码中打印传入参数的个数和类型。
因此，具体解决方案需要根据实际代码进行调整。
但是，由于给出的错误信息是明确的
索引越界（长度为0，访问索引4），所以最可能的原因是：调用Mapper方法时传入的参数数组长度为0（即没有传入任何参数），而方法需要至少5个参数（因为要访问第5个参数，索引4）。
请检查调用Mapper方法的代码，确保没有漏掉参数。
另外，还有一种可能是：在使用SqlSession调用方法时，参数传递错误。例如：
sqlSession.insert("insertBatch"); // 没有传入参数
或者：
sqlSession.insert("insertBatch", null, null, null, null); // 传入四个null，但还是不够五个，所以索引4仍然
越界
所以，请仔细检查调用代码。
</think>### 问题分析：
MyBatis批量插入时出现 `
IndexOutOfBoundsException: Index 4 out of bounds for length 0`
#### 原因：
当使用
MyBatis进行批量插入操作时，此
异常通常由以下原因导致：
1. **SQL参数绑定不匹配**：Mapper XML中的SQL语句引用了不存在的参数位置（如`#{param4}`），但实际传入的参数不足
2. **动态SQL处理缺陷**：`<foreach>`标签处理空集合时，某些
MyBatis版本（特别是3.4.x之前）存在边界处理缺陷
3. **参数传递错误**：Mapper接口方法参数与XML中`collection`属性指定的名称不匹配
4. **空集合处理不当**：传入的List实际为空（size=0），但未在SQL中进行空集合检查
#### 解决方案：
##### 1. 检查SQL参数绑定（关键步骤）
```xml
<!-- 错误示例：直接使用param索引 -->
<insert id="batchInsert">
INSERT INTO table
VALUES
<foreach collection="list" item="item" separator=",">
(#{param1}, #{param2}, #{param3}, #{param4}) <!-- 索引4可能
越界 -->
</foreach>
</insert>
<!-- 正确写法：使用item属性 -->
<insert id="batchInsert">
INSERT INTO table(col1, col2, col3, col4)
VALUES
<foreach collection="list" item="item" separator=",">
(#{item.field1}, #{item.field2}, #{item.field3}, #{item.field4})
</foreach>
</insert>
```
##### 2. 添加空集合检查
```xml
<insert id="batchInsert">
<if test="list != null and list.size() > 0">
INSERT INTO table(col1, col2)
VALUES
<foreach collection="list" item="item" separator=",">
(#{item.field1}, #{item.field2})
</foreach>
</if>
<!-- 空集合时跳过SQL执行 -->
</insert>
```
##### 3. 验证参数名称一致性
```java
// Mapper接口
public interface UserMapper {
// ✅ 确保@Param("list")与XML中的collection="list"匹配
void batchInsert(@Param("list") List<User> users);
}
// 调用代码
List<User> userList = Arrays.asList(new User(...));
userMapper.batchInsert(userList); // 确保传入非空集合
```
##### 4. 升级
MyBatis版本（如使用旧版）
```xml
<!-- pom.xml -->
<dependency>
<groupId>org.
mybatis</groupId>
<artifactId>
mybatis</artifactId>
<version>3.5.13</version> <!-- 修复了foreach空集合问题 -->
</dependency>
```
#### 完整正确示例：
```xml
<!-- UserMapper.xml -->
<insert id="batchInsertUsers">
<if test="users != null and users.size() > 0">
INSERT INTO users(name, email, age)
VALUES
<foreach collection="users" item="user" separator=",">
(#{user.name}, #{user.email}, #{user.age})
</foreach>
</if>
</insert>
```
```java
// Mapper接口
public interface UserMapper {
void batchInsertUsers(@Param("users") List<User> users);
}
// 调用代码
public void safeInsert(List<User> userList) {
if (userList != null && !userList.isEmpty()) {
userMapper.batchInsertUsers(userList);
} else {
logger.warn("插入空用户列表被跳过");
}
}
```
#### 根本预防措施：
1. **始终检查集合非空**：在Java代码和
MyBatis XML中添加空集合校验
2. **使用Item属性绑定**：避免直接使用`#{paramX}`索引位置引用
3. **启用
MyBatis日志**：查看实际执行的SQL和参数绑定过程
```yaml
# application.yml
logging:
level:
org.
mybatis: DEBUG
```
4. **单元测试边界情况**：专门测试空集合传入场景
---
###
扫一扫
973
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
