Mybatis 传list 参数出现 nested exception is org.apache.ibatis.binding.BindingException: Parameter ‘xxx’ not found.
一、问题描述：
nested exception is org.apache.ibatis.binding.BindingException: Parameter ‘planSiteList’ not found.
@Insert("<script>INSERT INTO r_plan_site (id, plan_id, site_id, order_number, create_time, status) " +
"VALUES" +
"<foreach collection =\"planSiteList\" item=\"planSite\" index= \"index\" separator =\",\"> " +
"(#{id}, #{planId}, #{siteId}, #{orderNumber}, #{createTime}, #{status})" +
"</foreach>" +
"</script>")
int addPlanSiteDOList( List<PlanSiteDO> planSiteList);
1234567
1、解决方案一：
添加注解@Param
2、解决方案二：
使用Myabtis默认的写法， 修改collection为 list
3、原因分析
foreach元素的属性主要有item，index，collection，open，separator，close。item表示集合中每一个元素进行迭代时的别名，index指定一个名字，用于表示在迭代过程中，每次迭代到的位置，open表示该语句以什么开始，separator表示在每次进行迭代之间以什么符号作为分隔符，close表示以什么结束，在使用foreach的时候最关键的也是最容易出错的就是collection属性，该属性是必须指定的，但是在不同情况下，该属性的值是不一样的，主要有一下3种情况：
- 如果传入的是单参数且参数类型是一个List的时候，==collection属性值为list ==.
- 如果传入的是单参数且参数类型是一个array数组的时候，==collection的属性值为array ==.
- 如果传入的参数是多个的时候，我们就需要把它们封装成一个Map了，当然单参数也可以封装成map，实际上如果你在传入参数的时候，在MyBatis里面也是会把它封装成一个Map的，map的key就是参数名，所以这个时候collection属性值就是传入的List或array对象在自己封装的map里面的key.
4、Mybatis默认参数传递方式
Mybatis关于各种类型的单参数默认的写法如下：
| 类型 | 接收参数方式 |
|---|---|
| 基本数据类型 | 顺序，如#{0}，也可以用name直接获取，如#{name} |
| List | list |
| 数组 | array |
| Map | 根据key获取map中各参数即可，如#{key} |
| 自定义的对象 | 根据get方法对应的参数，使用name获取即可，如#{name} |
如果是多参数，比如public User find(String address, List idList), 使用注解@Param("")或者考虑封装在map中传递。
报错信息如下：
org.mybatis.spring.MyBatisSystemException:
nested exception is org.apache.ibatis.binding.BindingException: Parameter 'roleIds' not found. Available parameters are [0, 1, param1, param2]
出现上面异常的原因：
*mapper.xml映射没有得到传入的参数，这个时候需要在DAO变化传参。
在使用mybatis开发的时候，有时候需要传入多个参数进行查询，当传入多个参数时，不处理便会出现上面的异常报错，这时需要用到一个注解
@Param
用注解来简化xml配置的时候,@Param注解的作用是给参数命名,参数命名后就能根据名字得到参数值,正确的将参数传入sql语句中。简单说就是@Param("orId2") String orId1 在启动时生成一个orId2的属性，把参数orId1的值赋给orId2，这样就可以在申请了中使用#{orId2} 或者${orId2}获取变量，如果不配置@Param("orId2")，就不会有orId2属性，只能用默认的#{orId1}来取值。
下面对比一下错误的和正确的传参方式：
错误：
int insertObject(Integer userId,Integer[] roleIds);
正确：
int insertObject(@Param("userId")Integer userId,@Param("roleIds")Integer[] roleIds);
使用@Param注意事项：
使用@Param注解
1.当以下面的方式进行写SQL语句时：
@Select("select column from table where userid = #{userid} ")
public int selectColumn(int userid);
2.当你使用了使用@Param注解来声明参数时，如果使用 #{} 或 ${} 的方式都可以。
@Select("select column from table where userid = ${userid} ")
public int selectColumn(@Param("userid") int userid);
3.当你不使用@Param注解来声明参数时，必须使用使用 #{}方式。如果使用 ${} 的方式，会报错。
@Select("select column from table where userid = ${userid} ")
public int selectColumn(@Param("userid") int userid);
不使用@Param注解
不使用@Param注解时，参数只能有一个，并且是Javabean。在SQL语句里可以引用JavaBean的属性，而且只能引用JavaBean的属性。
// 这里id是user的属性
@Select("SELECT * from Table where id = ${id}")
Enchashment selectUserById(User user);
实例一 @Param注解单一属性
dao层示例
Public User selectUser(@param(“userName”) String name,@param(“userpassword”) String password);
xml映射对应示例：
<select id=" selectUser" resultMap="BaseResultMap">
select * from user_user_t where user_name = #{userName，jdbcType=VARCHAR} and user_password=#{userPassword,jdbcType=VARCHAR}
</select>
注意：采用#{}的方式把@Param注解括号内的参数进行引用（括号内参数对应的是形参如 userName对应的是name）；
实例二 @Param注解JavaBean对象
dao层示例
public List<user> getUserInformation(@Param("user") User user);
xml映射对应示例：
<select id="getUserInformation" parameterType="com.github.demo.vo.User" resultMap="userMapper">
select
<include refid="User_Base_Column_List" />
from mo_user t where 1=1
<!-- 因为传进来的是对象所以这样写是取不到值得 -->
<if test="user.userName!=null and user.userName!=''">
and t.user_name = #{user.userName}
</if>
<if test="user.userAge!=null and user.userAge!=''">
and t.user_age = #{user.userAge}
</if>
</select>