【异常】Mybatis提示Parameter ‘projectId‘ not found. Available parameters are [arg1, arg0, param1, param2]

已于 2024-03-14 00:39:05 修改
阅读量1.3k 收藏
点赞数
CC 4.0 BY-SA版权
分类专栏： 003 - 数据库 文章标签： mybatis java spring
于 2023-03-10 15:15:16 首次发布
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/wstever/article/details/129443090
在使用Mybatis时遇到了'Parameter 'projectId' not found'的异常。该问题出现在Repository接口层和Mapper层。解决方法是在相关方法上添加注解，确保注解中的参数名与#{}中的内容匹配。

摘要生成于 C知道 ，由 DeepSeek-R1 满血版支持， 前往体验 >

一、异常内容

Caused by: org.apache.ibatis.binding.BindingException: Parameter 'projectId' not found. Available parameters are [arg1, arg0,<
了解本专栏 订阅专栏 解锁全文 超级会员免费看
解决错误 “Parameter ‘username‘ not found. Available parameters are [arg1, arg0, param1]“ 的方法详解
pleaseprintf的博客
07-12 7390
在开发应用程序时，有时可能会遇到错误信息 “Parameter ‘username’ not found. Available parameters are [arg1, arg0, param1]”，该错误表明在参数列表中找不到 ‘username’ 参数。本文将介绍如何解决这个错误，帮助你正确传递参数并避免出现问题。
Parameter ‘projectId‘ not found. Available parameters are 异常解决
我不是大牛啊
01-13 1490
错误代码： 解决方法： @Param(“projectID”) 与mapper.xml中 #{projectId} 不匹配改成一致便可
Mybatis报错: Parameter ‘XXX‘ not found. Available parameters are [arg1, arg0, param1, param2]解决方案及问题原因
程序猿追的博客
08-30 2万+
哈喽~大家好，这专栏是记录经常出现的报错一些问题，这篇来看看Mybatis报错: Parameter ‘XXX‘ not found. Available parameters are [arg1, arg0, param1, param2]解决方案及问题原因。
Mybatis 错误日志：Parameter ‘productId‘ not found. Available parameters are [arg1, arg0, param1, param2]
huanfeng_AI的博客
08-31 923
日志详情出现这种原因是由于在mapper的接口上没有使用@Param导致的，更改一下就好了：
Parameter ‘0‘ not found.Available parameters are [arg1, arg0, param1, param2]的解决方法
代码是程序员的语言，博客是思想的桥梁，连接你我，共享智慧之光。
12-30 2769
错误信息表明在MyBatis中存在参数绑定的问题，具体为找不到名为'category'的参数。MyBatis无法找到'category'参数，并列出了可用的参数为'arg1'、'arg0'、'param1'和'param2'。mybatis的dao层函数参数列表有多个参数，直接传到mapper.xml匹配报错！使用#{arg0}和#{arg1}来告诉mybatis,当前变量使用哪个参数的值。HashMap类型作为传入类型（不修改mapper.xml)使用注解@Param。
已解决：Parameter ‘sessionId‘ not found. Available parameters are [arg1, arg0, param1, param2]
qq_45559559的博客
04-06 637
这种错误应该是参数有多个，没有指定名称导致的，所以当参数有多个时，我们需要指定参数名称要在mapper接口中使用@Param注解指定名称。
【解决方法】Parameter ‘***‘ not found. Available parameters are [arg1, arg0, param1, param2]
xxx521314的博客
04-17 552
报错nested exception is org.apache.ibatis.binding.BindingException: Parameter 'baomingid' not found. Available parameters are [arg1, arg0, param1, param2]接口中，传入的参数有多个时必须使用。的包，查看一下导入的包，确定没导错。，查看代码是否都用了。
关于Parameter ‘xxx‘ not found. Available parameters are [arg1, arg0, param1, param2]报错的问题
热门推荐
weixin_49891946的博客
01-15 2万+
当使用单个参数没有使用@Param注解进行标注的方式进行传值时，就会出现参数xxx找不到的问题。如下图这种没有加注解的 问题分析：在没有@Param注解指定参数名时，底层使用的是一个HashMap集合，把每个参数以key为arg0…argN值为实际参数和key为param1…paramN值为实际参数依次存入到HashMap集合中，例如：{arg0=1000,param1=1000,arg1=lisi,param2=lisi…}，在进行执行的时候会用mapper文件中sql的占位参数名去集合中获取，获取不到
MyBatis3错误：Parameter 'id' not found. Available parameters are [arg2, arg1, arg0, param3, param1, par...
angou6476的博客
06-20 508
这个问题涉及到MyBatis3在使用select节点查询时传递多个参数的问题。问题分析如下： 1、如果是单个查询一般是这样配置： <select id="getUserArticles" parameterType="int" resultMap="resultUserArticleList"> select user.id,user.use...
myBatis 处理多个参数：Parameter ‘id‘ not found. Available parameters are [arg1, arg0, param1, param2]
u014141841的博客
09-14 2328
方法 Employee selectByIdAndLastname(Integer id,String lastName); 取值 <select id="selectByIdAndLastname" resultType="com.paul.mybatis.pojo.Employee"> select * from employee where id =#{id} and last_name=#{lastName} </select> 结果 Caused by:
Mybatis报错: Parameter 'XXX' not found. Available parameters are [arg1, arg0, param1, param2]解决方案及问题根源
sparrow学习博客
07-26 1万+
造成此问题的原因通常是Dao层的方法含有多个参数 废话不多说，先上解决方案 解决方案一：在参数前加上@Param注解 解决方案二：修改idea设置 File->Settings->Build,Execution,Deployment->Compiler->Java Compiler ...
日常记录--Mybatis报错：Available parameters are [arg1, arg0, param1, param2]
weixin_44388890的博客
10-28 5148
记录今天做需求的时候，出现的一个mybatis的bug 报错内容：Available parameters are [arg1, arg0, param1, param2] 报错原因：没有识别传入的参数。 解决方法：使用@Param绑定参数。 DAO层代码： List<PayInQueryVO> queryPayList(Date orderStartTime,Date orderEndTime); 现在需要传入两个参数，分别为订单开始时间和订单结束时间。 根据错误提示，发现它说它没有识别我
Parameter ‘pageNum‘ not found. Available parameters are [arg1, arg0, param1, param2]
qq_52889347的博客
11-15 3889
Parameter 'pageNum' not found. Available parameters are [arg1, arg0, param1, param2]报错原因以及解决方法
Parameter 'acId' not found. Available parameters are [arg1, arg0, param1,param2]
Walker_m的博客
06-30 744
在Dao中，使用这个一直报错：Parameter 'acId' not found. Available parameters are [arg1, arg0, param1,param2]        public List&lt;String&gt; searchByKeyWords(String acId,String keyword);然后在参数中假如注解：@Param        p...
Mybatis异常Available parameters are [arg1, arg0, param1, param2]
yjt520557的博客
03-26 5063
org.springframework.web.util.NestedServletException: Request processing failed; nested exception is org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.binding.BindingExce...
Available parameters are [arg1, arg0, param1, param2]
MIYAOW
07-17 6344
Mybatis 多参数传递的时候遇到问题。 例如 public List getUserByParam(User user,Integer pageNo,Integer pageSize); Parameter 'user_name' not found. Available parameters are [2, 1, 0, param1, param2, param3]
Parameter ‘status‘ not found. Available parameters are [arg1, arg0, param1, param2]
qq_51541555的博客
02-02 975
从控制层传递多个参数，mapper（dao）层，不能区分。：在mapper或dao层的参数接收时添加@Param注解。
Mybatis报错：Available parameters are [arg1, arg0, param1, param2]
c17315377559的博客
10-22 2万+
报错案例： 接口： void updateUserInfo(int money, String user_id); 映射文件： <update id="updateUserInfo"> update t_user set points = points + #{money}where user_id = #{user_id} </upda...
Mybatis相关：当mybatis 方法参数为多个时报错Available parameters are [arg1, arg0, param1, param2]
zitian246的博客
10-25 450
当使用mybaits传递多个参数时，异常抛出如下： org.apache.ibatis.binding.BindingException: Parameter 'name' not found. Available parameters are [arg1, arg0, param1, param2] 解决方案 将多个参数封装为对象或map集合进行传输，即可传对象或传map 使用arg0 arg1...... 或者 param1 param2等命名 先将参数声明，再使用@Param给参数...
nested exception is org.apache.ibatis.binding.BindingException: Parameter 'deal_status' not found. Available parameters are [collection, list]
最新发布
07-09
<think>我们正在解决MyBatis中出现的参数绑定异常：Parameter 'deal_status' not found. Available parameters are [collection, list]。 根据引用[3]中提到的类似错误：Parameter 'projectId' not found. Available parameters are [arg1, arg0, param1, ...]，我们可以推断这是MyBatis在参数传递时出现了问题。 在MyBatis中，当我们在Mapper接口中定义方法时，如果方法有多个参数，并且没有使用@Param注解来指定参数名，那么MyBatis默认会使用参数的位置来命名（如arg0, arg1, param1, param2等）。而在Mapper XML中，我们使用参数名来引用参数时，如果参数名不匹配，就会抛出BindingException。 用户遇到的问题中，方法参数可能是一个集合（或列表）和一个其他类型的参数，而MyBatis给出的可用参数是[collection, list]，这通常发生在使用foreach标签时，MyBatis会为可迭代参数创建一些内置参数名。 具体到用户的问题：Parameter 'deal_status' not found. Available parameters are [collection, list]。这说明在XML中使用了'deal_status'这个参数名，但是MyBatis并没有找到这个参数，而可用的参数是[collection, list]。这通常是因为我们传递了一个集合（比如List）作为参数，而MyBatis在解析这个集合时，会将其视为一个集合参数，并为其创建默认的参数名：collection（或者list，取决于版本，但通常两者都可用）。 但是，用户试图使用'deal_status'这个参数，这显然不是集合的默认参数名。因此，我们需要检查Mapper接口和XML配置。 可能的原因及解决方案： 1. 方法只有一个参数（一个集合），但XML中却引用了'deal_status'。这时，应该使用默认的集合参数名（如collection或list）来引用整个集合，或者使用@Param注解指定参数名。 2. 方法有两个或多个参数，其中一个参数是集合，另一个是其他类型（比如deal_status），但是没有使用@Param注解。在这种情况下，MyBatis无法识别参数名，只能使用默认的位置参数名（arg0, arg1等）或者使用param1, param2。而如果其中一个参数是集合，在foreach标签中，MyBatis会为该集合参数额外创建两个别名：collection和list（仅当参数类型为List时，可以使用list作为别名）。但是，非集合参数不会自动有别名，所以需要按位置引用。 因此，解决方案是： 方案一：使用@Param注解明确指定参数名。 例如，在Mapper接口中： List<SomeType> someMethod(@Param("deal_status") String dealStatus, @Param("ids") List<Integer> ids); 然后在XML中，就可以使用#{deal_status}和#{ids}来引用参数了。注意，在foreach标签中，collection属性应该指定为我们在@Param中为集合参数指定的名字，即"ids"。 方案二：如果方法只有一个集合参数，那么应该使用默认的集合参数名（collection或list）来引用，而不是'deal_status'。例如： List<SomeType> someMethod(List<Integer> ids); 在XML中，foreach的collection属性应该设置为"list"（如果参数类型是List）或"collection"（通常也可以使用，但更推荐使用list）。 但是，用户的问题中可用参数是[collection, list]，说明传递的参数是一个集合（可能是List），所以MyBatis为其创建了这两个别名。而用户试图使用'deal_status'，说明这个参数名在XML中使用了，但并没有在方法参数中通过@Param注解声明。 因此，我们需要检查Mapper接口的方法定义和对应的XML文件。 假设用户的方法类似于： List<SomeType> selectByDealStatusAndIds(String deal_status, List<Integer> ids); 那么，由于没有使用@Param注解，MyBatis会使用默认的参数名：arg0（对应deal_status）和arg1（对应ids）。同时，因为第二个参数是List，所以它还有两个别名：collection和list。但是第一个参数deal_status并没有别名，所以只能通过arg0或param1来引用。 在XML中，如果我们这样写： <select ...> ... where deal_status = #{deal_status} and id in <foreach collection="ids" item="id" open="(" separator="," close=")"> #{id} </foreach> </select> 这里，第一个参数引用#{deal_status}会失败，因为MyBatis不知道deal_status就是arg0。同样，foreach中的collection属性写的是"ids"，但MyBatis并不知道ids就是arg1，所以也会失败。 正确的做法是： 1. 使用@Param注解： List<SomeType> selectByDealStatusAndIds(@Param("deal_status") String dealStatus, @Param("ids") List<Integer> ids); 然后在XML中，就可以使用#{deal_status}和foreach中的collection="ids"。 2. 如果不使用@Param，则使用默认的参数名（不推荐，因为可读性差且容易出错）： where deal_status = #{arg0} and id in <foreach collection="arg1" item="id" ...> ... </foreach> 或者使用param1, param2（这是MyBatis为多参数提供的另一种命名方式）： where deal_status = #{param1} and id in <foreach collection="param2" item="id" ...> ... </foreach> 注意：对于集合参数，在foreach标签中，我们也可以使用list（如果参数类型是List）或collection（通用）作为别名，但这只适用于只有一个集合参数的情况。如果有多个参数，且其中一个参数是集合，那么我们必须使用@Param注解来指定集合参数的名字，否则在foreach中只能使用默认的参数名（arg1, param2等）或者别名（如果有，但多个集合参数时别名会冲突）。 因此，强烈推荐使用@Param注解。 根据用户的问题，错误信息中可用参数是[collection, list]，说明在方法中有一个集合参数（可能是唯一的参数，或者是多个参数中的一个，但MyBatis只报告了集合的别名）。用户试图使用'deal_status'，说明这个参数应该是存在的，所以很可能方法有多个参数。 因此，我们建议用户检查Mapper接口方法，并为每个参数添加@Param注解。 另外，引用[3]中的例子也是类似，他们使用了两个参数，但没有使用@Param注解，导致MyBatis无法识别参数名。他们的解决方案也是使用@Param注解。 总结：在MyBatis的Mapper接口中，如果方法有多个参数，应该为每个参数使用@Param注解指定名称，然后在XML中引用这些名称。 示例代码： Mapper接口： @Repository public interface SomeMapper { List<SomeType> selectByCondition(@Param("deal_status") String dealStatus, @Param("id_list") List<Integer> idList); } XML映射文件： <select id="selectByCondition" resultType="SomeType"> SELECT * FROM some_table WHERE deal_status = #{deal_status} AND id IN <foreach collection="id_list" item="id" open="(" separator="," close=")"> #{id} </foreach> </select> 这样，参数deal_status和id_list都能正确绑定。 如果用户已经使用了@Param注解但仍然出现错误，那么请检查注解中的名称是否与XML中引用的名称完全一致（包括大小写，因为MyBatis参数名默认是区分大小写的）。 另外，注意在foreach标签中，collection属性必须指定为@Param注解中为集合参数指定的名称（本例中为"id_list"），而不是集合对象的属性（如list或collection）。 最后，如果用户使用的是MyBatis 3.4.1及以上版本，还可以通过配置`useActualParamName`来使用实际的参数名（不需要@Param注解），但要求编译时保留参数名（即使用-parameters编译选项）。但为了兼容性和清晰性，通常推荐使用@Param注解。</think>### 解决 MyBatis 的 BindingException 参数绑定错误 当 MyBatis 抛出 `Parameter 'xxx' not found. Available parameters are [...]` 错误时，通常是因为 **Mapper 接口方法参数名与 XML 中占位符名称不匹配**。以下是具体原因和解决方案： --- ### 错误原因分析（以您的问题为例） ```java // Mapper 接口方法可能类似这样 List<Data> selectData(@Param("list") List<Integer> idList, String deal_status); ``` ```xml <!-- XML 中错误地引用了未声明的参数名 --> <select id="selectData"> SELECT * FROM table WHERE deal_status = #{deal_status} <!-- 此处触发错误 --> AND id IN <foreach collection="list" item="id" open="(" separator="," close=")"> #{id} </foreach> </select> ``` 错误信息： ```bash Parameter 'deal_status' not found. Available parameters are [list, collection] ``` **原因**： 1. 多参数方法未正确使用 `@Param` 注解命名参数 2. MyBatis 对集合参数（如 List）自动生成默认别名 `collection` 或 `list` 3. 非集合参数（如 `deal_status`）未显式命名，无法被 XML 识别 --- ### 解决方案 #### 方法 1：为所有参数添加 `@Param` 注解（推荐） ```java // Mapper 接口修改 List<Data> selectData( @Param("idList") List<Integer> idList, // 显式命名集合参数 @Param("dealStatus") String deal_status // 显式命名普通参数 ); ``` ```xml <select id="selectData"> SELECT * FROM table WHERE deal_status = #{dealStatus} <!-- 使用注解定义的名称 --> AND id IN <foreach collection="idList" item="id"> <!-- 使用注解定义的集合名 --> #{id} </foreach> </select> ``` #### 方法 2：使用 MyBatis 内置参数别名 ```xml <!-- 通过 param1, param2... 按位置引用参数 --> WHERE deal_status = #{param2} <!-- 第一个参数是 param1, 第二个是 param2 --> AND id IN <foreach collection="param1" item="id"> <!-- param1 对应第一个参数 --> #{id} </foreach> ``` #### 方法 3：单参数时直接使用属性名 ```java // 如果只有一个 POJO 对象参数 List<Data> selectData(QueryParams params); ``` ```java // QueryParams.java public class QueryParams { private String dealStatus; private List<Integer> idList; // getters & setters } ``` ```xml <!-- XML 直接使用对象属性名 --> WHERE deal_status = #{dealStatus} AND id IN <foreach collection="idList" item="id"> #{id} </foreach> ``` --- ### 关键注意事项 1. **集合参数规则**： - List 类型默认别名：`list` 或 `collection` - 数组类型默认别名：`array` - 推荐始终用 `@Param` 显式命名集合 2. **参数匹配优先级**： ```mermaid graph LR A[XML占位符 #{xxx}] --> B{是否有@Param'xxx'?} B -->|是| C[使用注解定义的参数] B -->|否| D{是否单参数对象?} D -->|是| E[使用对象属性名] D -->|否| F[按位置使用param1/2...] ``` 3. **排查技巧**： - 检查编译后的 `.class` 文件是否保留参数名（需 `-parameters` 编译选项） - 使用 MyBatis 日志查看解析后的参数映射： ```ini # mybatis-config.xml <configuration> <settings> <setting name="logImpl" value="STDOUT_LOGGING"/> </settings> </configuration> ``` > 根据引用[3]的类似案例，该错误本质是参数名称解析失败[^3]。通过显式声明参数名可确保 MyBatis 正确绑定值。 --- ### 相关问题 1. **如何避免 MyBatis 中集合参数的命名冲突？** > 使用 `@Param` 为每个集合参数指定唯一名称，避免依赖默认别名（如 list/collection） 2. **MyBatis 多表关联查询时出现参数绑定异常该如何处理？** > 需检查嵌套查询中的参数传递路径，使用 `@Param` 明确作用域 3. **为什么 MyBatis 要求接口方法添加 `@Param` 注解？** > Java 编译默认不保留方法参数名，通过注解显式声明可确保 XML 正确引用参数[^3] 4. **MyBatis 的 `#{}` 和 `${}` 在参数处理上有何区别？** > `#{}` 使用预编译防止 SQL 注入，`${}` 直接拼接字符串，后者更易引发绑定错误 [^1]: 引用自 Activiti 的版本更新日志，涉及参数处理相关的 Bug 修复 [^3]: 引用自 MyBatis 参数绑定异常的典型解决方案
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

本本本添哥

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值