<think>我们正在解决
MyBatis批量插入部门列表时出现的参数绑定异常
问题。根据引用[
1]和引用[2]中的信息，异常信息类似于：`Parameter 'deptList' not found
. Available parameters are [collection, list]` 或类似提示。这表明
MyBatis在映射参数时没有找到名为`deptList`的参数，而是提供了可用的参数名如`collection`或`list`。
原因分析：
在
MyBatis中，当我们传入一个集合（List）作为参数时，
MyBatis默认会将其转换为一个Map，其中包含两个键：
- `list`：指向传入的List对象
- `collection`：同样指向传入的List对象（在
MyBatis 3
.3
.0及之前，只有`list`和`collection`这两个别名，而在3
.3
.1之后，
MyBatis增加了对`arg0`和`param
1`的支持，但集合类型仍然有特殊处理）
因此，在Mapper XML文件中，如果我们直接使用`#{deptList}`来引用传入的List参数，
MyBatis会找
不到这个参数，因为
MyBatis并没有使用我们定义的参数名（例如`deptList`）来存储，而是使用了默认的`list`或`collection`。
解决方案：
1. 使用默认的参数名`list`或`collection`：
在Mapper XML文件中，将`#{deptList}`改为`#{list}`或`#{collection}`。但是这种方法可读性差，且容易混淆。
2
. 使用@Param注解指定参数名（推荐）：
在Mapper接口的方法参数前添加`@Param`注解，为参数指定一个名字，然后在XML中使用这个名字。
例如，将接口方法：
int batchInsertDepts
(List<Dept> deptList);
改为：
int batchInsertDepts
(@Param
("deptList") List<Dept> deptList);
然后在XML中，我们就可以使用`#{deptList}`来引用这个参数了。同时，在动态SQL（如foreach）中，我们可以这样写：
<foreach collection
="deptList" item
="dept" separator
=",">
(#{dept
.name}, #{dept
.code})
</foreach>
3
. 如果使用
MyBatis 3
.4
.1及以上版本，可以修改配置参数`useActualParamName`（默认
值为true），这样
MyBatis会使用实际的参数名（但要求编译时开启参数保留，比如使用
Java 8的-parameters选项或使用IDE的保留参数名编译选项）。但是，对于集合类型，仍然建议使用@Param注解以避免混淆。
根据引用[3]和[4]的内容，我们还可以了解到，
MyBatis的binding模块是为了提前发现接口方法与XML之间的绑定错误，类似于泛型的作用。因此，正确的参数绑定非常重要。
具体步骤：
假设我们有一个批量插入部门的方法，接口定义如下：
public interface DeptMapper {
int batchInsertDepts
(List<Dept> deptList);
}
出现异常的原因是，在XML中我们可能这样写：
<insert id
="batchInsertDepts">
INSERT INTO dept
(name, code)
VALUES
<foreach collection
="deptList" item
="dept" separator
=",">
(#{dept
.name}, #{dept
.code})
</foreach>
</insert>
这里，`collection
="deptList"`会导致异常，因为
MyBatis并
不知道`deptList`这个参数名。
修改方法：
在接口方法上添加@Param注解：
int batchInsertDepts
(@Param
("deptList") List<Dept> deptList);
这样，在XML中就可以使用`deptList`作为集合参数名了。
另外，如果
不想修改接口，也可以将XML中的`collection`属性改为`list`（因为
MyBatis默认给List类型参数取名为`list`）：
<foreach collection
="list" item
="dept" separator
=",">
(#{dept
.name}, #{dept
.code})
</foreach>
但是，这种方法在方法有多个参数时容易出错，因此推荐使用@Param注解。
总结：
出现`Parameter 'deptList' not found`异常的原因是
MyBatis对集合参数使用了默认的命名（`list`或`collection`），而
不是我们定义的参数名。通过使用@Param注解明确指定参数名，可以解决这个
问题。
如果
问题仍然存在，请检查
MyBatis的版本，并确保在配置中正确设置了参数名的处理方式（如`useActualParamName`）。另外，确保在编译时保留了方法参数名（对于
Java 8及以上，可以在编译时添加`-parameters`选项；对于Maven项目，可以在`maven-compiler-plugin`中配置）。
相关
问题：
1. MyBatis中如何传递多个参数？
2
. 除了@Param注解，还有哪些方式可以解决参数绑定
问题？
3
. MyBatis的foreach标签有哪些属性？分别是什么作用？</think>### 解决
MyBatis 插入部门列表时参数绑定异常
当
MyBatis 批量插入部门列表出现 `Parameter 'deptList' not found` 异常时，根本原因是 **
MyBatis 对集合类型参数的默认命名规则与自定义参数名
不匹配**。以下是完整解决方案：
---
### 原因分析
1. **
MyBatis 的集合参数默认命名规则**（[^2]）：
- 直接传入 `List` 时，
MyBatis 会将其转换为内置参数名 `list` 或 `collection`
- 错误示例：`batchInsertDepts
(List<Dept> deptList)` 在 XML 中直接使用 `#{deptList}` 会报错
2
. **参数绑定机制**：
-
MyBatis 通过反射获取参数名，若编译未保留参数名（如未加 `-parameters` 编译选项），会使用 `param
1, param2
...` 代替（[^4]）
---
### 解决方案（推荐两种）
#### ✅ 方案一：使用 `@Param` 注解显式命名（最佳实践）
```
java
// Mapper 接口修改
int batchInsertDepts
(@Param
("deptList") List<Dept> deptList); // 关键注解
```
```xml
<!-- XML 中使用自定义名称 -->
<insert id
="batchInsertDepts">
INSERT INTO dept
(name, code)
VALUES
<foreach collection
="deptList" item
="dept" separator
=","> <!-- 此处匹配 deptList -->
(#{dept
.name}, #{dept
.code})
</foreach>
</insert>
```
#### ✅ 方案二：使用
MyBatis 内置默认名称
```xml
<foreach collection
="list" item
="dept" separator
=","> <!-- 使用默认名称 list -->
(#{dept
.name}, #{dept
.code})
</foreach>
```
---
### 其他注意事项
1. **
MyBatis 版本
问题**：
```xml
<!-- 建议使用较新版本（3
.5+） -->
<dependency>
<groupId>org
.mybatis.spring
.boot</groupId>
<art
ifactId>
mybatis-spring-boot-starter</art
ifactId>
<version>2
.2
.0</version> <!-- 最低要求
1.3
.2+ 避免旧版 bug [^3] -->
</dependency>
```
2
. **编译参数设置**（Maven 示例）：
```xml
<plugin>
<groupId>org
.apache
.maven
.plugins</groupId>
<art
ifactId>maven-compiler-plugin</art
ifactId>
<configuration>
<compilerArgs>
<arg>-parameters</arg> <!-- 保留参数名 -->
</compilerArgs>
</configuration>
</plugin>
```
3
. **参数检查清单**：
- 确认 `collection` 属性
值与 `@Param` 或默认名一致
- 确保 `item` 属性（如 `dept`）与 `#{dept
.xxx}` 匹配
- 检查 SQL 语句中无其他未定义参数
---
### 根本原理解析
MyBatis 处理集合参数时，会将其封装为 `Map` 对象：
```
java
// 未用 @Param 时实际参数结构
map
.put
("list", deptList); // 默认 key
1
map
.put
("collection", deptList); // 默认 key2
```
使用 `@Param
("deptList")` 后：
```
java
map
.put
("deptList", deptList); // 自定义 key 生效
```
这种设计确保了类型安全，类似
Java 泛型机制（[^4]）。
---
扫一扫
1万+
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
