MyBatis批量插入时Parameter ‘carNum‘ not found错误的解决方法_Java

一、错误现象

运行批量插入测试时抛出：

org.apache.ibatis.binding.bindingexception: parameter 'carnum' not found. 
available parameters are [cars, param1]

并且 sql 显示为：

insert into t_car car_num,brand,guide_price,produce_time,car_type values (?,?,?,?,?) , (?,?,?,?,?)

二、错误含义

这个错误包含两个问题：

参数绑定错误：parameter ‘carnum‘ not found — xml 中使用了 #{carnum}，但 mybatis 找不到名为 carnum 的参数。
sql 语法错误：insert into t_car car_num,brand,... — insert 语句中表名后面缺少左括号 (。

三、根本原因分析

3.1 问题一：参数绑定错误

查看你的 xml 配置，<foreach> 中很可能写成了：

<foreach collection="cars" item="car" separator=",">
    (#{carnum}, #{brand}, #{guideprice}, #{producetime}, #{cartype})
</foreach>

但是：

方法参数使用了 @param("cars")，类型是 list<car>
遍历时 item="car" 代表集合中的每个 car 对象
访问对象的属性时，必须加上 item 前缀：#{car.carnum}、#{car.brand}

错误写法：#{carnum}（mybatis 会从顶层参数中找名为 carnum 的单独参数，找不到）
正确写法：#{car.carnum}（从当前遍历的 car 对象中取 carnum 属性）

3.2 问题二：sql 语法错误

sql 语句：

insert into t_car car_num,brand,guide_price,produce_time,car_type values ...

应该是：

insert into t_car (car_num, brand, guide_price, produce_time, car_type) values ...

表名 t_car 后面缺少左括号 (。

3.3 从日志看具体问题

日志中显示：

parameter 'carnum' not found. available parameters are [cars, param1]

这说明 mybatis 的可用参数只有两个：cars（@param 注解名）和 param1（默认名）。当你写 #{carnum} 时，mybatis 会去查找名为 carnum 的顶层参数，但 carnum 既不是 @param("cars")，也不是 param1，所以找不到。

同时，生成的 sql 中字段列表缺少括号，这是 xml 中 insert 语句本身的问题。

四、解决方案

4.1 修正后的 xml

<insert id="insertmore">
    insert into t_car (car_num, brand, guide_price, produce_time, car_type)
    values
    <foreach collection="cars" item="car" separator=",">
        (#{car.carnum}, #{car.brand}, #{car.guideprice},
         #{car.producetime}, #{car.cartype})
    </foreach>
</insert>

4.2 修正点对比

错误写法	正确写法	说明
`insert into t_car car_num`	`insert into t_car (car_num`	表名后加 `(`
`#{carnum}`	`#{car.carnum}`	加上 `item` 前缀
`#{brand}`	`#{car.brand}`	加上 `item` 前缀
`#{guideprice}`	`#{car.guideprice}`	加上 `item` 前缀
`#{producetime}`	`#{car.producetime}`	加上 `item` 前缀
`#{cartype}`	`#{car.cartype}`	加上 `item` 前缀

4.3 完整示例

mapper 接口：

public interface carmapper {
    int insertmore(@param("cars") list<car> carlist);
}

xml 映射：

<insert id="insertmore">
    insert into t_car (car_num, brand, guide_price, produce_time, car_type)
    values
    <foreach collection="cars" item="car" separator=",">
        (#{car.carnum}, #{car.brand}, #{car.guideprice},
         #{car.producetime}, #{car.cartype})
    </foreach>
</insert>

测试代码：

@test
public void test6() {
    list<car> carlist = arrays.aslist(
        new car("京a11111", "宝马", 30.0, "2024-01-01", "燃油车"),
        new car("京a22222", "奔驰", 45.0, "2024-01-02", "燃油车")
    );
    carmapper.insertmore(carlist);
    sqlsession.commit();
}

五、#{}取值规则详解

在 <foreach> 中，#{} 的取值规则与普通场景不同：

写法	取值对象	说明
`#{carnum}`	顶层参数（map 的 key）	从方法参数中查找 `carnum` 这个 key
`#{car.carnum}`	`item` 对象的属性	从当前遍历的 `car` 对象中取 `carnum` 属性
`#{item.carnum}`	同上	如果 `item="item"`，写法为 `#{item.carnum}`

关键：在 <foreach> 内部，当 item 是对象时，必须通过 item.属性名 访问属性；当 item 是基本类型时，直接写 #{item} 即可。

六、常见错误速查表

错误信息	原因	解决方案
`parameter 'xxx' not found. available parameters are [cars, param1]`	未加 `item` 前缀	改为 `#{car.xxx}`
`parameter 'list' not found. available parameters are [cars, param1]`	`collection` 值写错	改为 `collection="cars"`
sql 语法错误 `near 'values (?,?,?)'`	表名后缺少 `(`	加上 `(car_num, brand, ...)`
插入成功但数据为 `null`	字段名写错	检查字段名是否匹配数据库列