Mybatis dao传递参数为List时，需要注意的点

问题

org.apache.ibatis.binding.BindingException: Parameter ‘advIds’ not found. Available parameters are [list]
在执行dao方法时，mybatis抛出了如上所示的异常

产生原因

当dao方法中传入的参数为一个List时，容易报上述异常，原因在于Mybatis会自动将传递的List参数封装成一个Map传递给xml中的sql语句，封装时，key被固定命名为：list，而value则是用户传入的list。
封装后的格式为：<”list”:Object（list）>

解决方案

方案一：

在sql中不适用参数的名称来获取参数，直接使用”list”获取
错误格式：

<select id="selectByAdvIdList" resultMap="BaseResultMap" parameterType="java.util.List" >
    select 
    <include refid="Base_Column_List" />
    from heim_adv
    where del_flag = '0' and id in
    <foreach collection="advIds" item="id" open="(" close=")" separator=",">
    #{id}
    </foreach>
  </select>

方案一修改后的方案（将foreach中的collection的名称改为list）：

<select id="selectByAdvIdList" resultMap="BaseResultMap" parameterType="java.util.List" >
    select 
    <include refid="Base_Column_List" />
    from heim_adv
    where del_flag = '0' and id in
    <foreach collection="lsit" item="id" open="(" close=")" separator=",">
    #{id}
    </foreach>
  </select>

局限性

方案一的决绝方案，可以解决此问题，但是在sql中直接使用list，不便于阅读时对该数据源的理解，增大了阅读理解sql的难度

方案二：

放弃使用list传递参数，在dao的方法中传递一个Map给sql中，map的key可以任意命名，value为需要传递到sql中的对象，那么在sql中可以通过对应的key取到传递的对象
推荐使用方案二的解决方法，便于用户理解数据源的意义。