MyBatis 通用mapper批量插入异常

最新推荐文章于 2025-06-06 23:27:03 发布

ljheee

最新推荐文章于 2025-06-06 23:27:03 发布

阅读量6.2k

点赞数 1

CC 4.0 BY-SA版权

分类专栏： MyBatis 文章标签： mybatis

本文链接：https://blog.youkuaiyun.com/ljheee/article/details/84258548

MyBatis 专栏收录该内容

3 篇文章

订阅专栏

本文解决在SSM框架下使用通用Mapper批量插入数据时遇到的ExecutorException异常，通过升级MyBatis版本至3.3.1以上，确保insertList方法正常工作，并避免参数绑定错误。

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

ExecutorException: Error getting generated key or setting result to parameter object.

Cause: org.apache.ibatis.binding.BindingException: Parameter 'id' not found. Available parameters are [list]

今天偶遇异常，查了相关文章，大部分说是因为参数绑定的异常，使用@Param 解决，但我的工程并非如此。

我的工程环境：SSM+通用mapper

用过通用mapper的都知道，通用mapper支持批量插入insertList ，直接传入一个PO的List即可；但就是在调用insertList 批量插入时抛出的此异常，奇怪的是，根据mybatis debug打印的日志，所有SQL语句都执行成功，执行SQL和参数打印的都没问题。

于是搜索到这篇文章，指出去除mybatis-config.xml中的开启获取自增主键或设为false
<setting name="useGeneratedKeys" value="true"/>
就不会抛出此异常。

改成false后，发现确实不抛此异常了。但是不巧的是业务方法需要在插入A表后，返回一个主键id，再去插入详情表B，如果设为false，在执行插入详情表B 时就报关联外键不能为null；

出于时间原因，立即把第一次插入表A的记录按插入条件查出，再获得查询返回对象的ID，设置给插入表B的关联自动，这次再执行，发现还是报出开始的异常：

ExecutorException: Error getting generated key or setting result to parameter object.

Cause: org.apache.ibatis.binding.BindingException: Parameter 'id' not found. Available parameters are [list]

后续又尝试了很多办法，一直解决不了，很多文章都是关于原生mybatis批量插入时的问题，通过修改mapper.xml的insert语句添加xml属性解决。

最后找到了通用mapper作者交流群，被问到自己工程使用的mybatis版本。发现自己工程，别人搭建之初使用的mybatis版本是3.0.6。
原因是：mybatis版本太低，不支持insertList批量插入，

支持通用mapper批量插入最低需要的版本 3.3.1。最后修改工程依赖如下，升级mybatis版本：

        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis</artifactId>
            <version>3.4.1</version>
        </dependency>
        <dependency>
            <groupId>org.mybatis</groupId>
            <artifactId>mybatis-spring</artifactId>
            <version>1.3.0</version>
        </dependency>

        <!--通用Mapper-->
        <dependency>
            <groupId>tk.mybatis</groupId>
            <artifactId>mapper</artifactId>
            <version>4.0.3</version>
        </dependency>

升级后，所有运行就正常了。

实际上，mybatis提供了返回插入后的主键ID，只需在mybatis-config.xml配置开启即可（此方式是全局通用设置）
<setting name="useGeneratedKeys" value="true"/>

当然也可以在单个方法上使用
@Options(useGeneratedKeys=true,keyProperty="id")
keyProperty是你POJO实体类与数据库主键映射的那个字段。