MyBatis批量插入对象列表仅最后一个元素重复执行两次问题求助

• XML中foreach循环变量引用错误：这是最高发的原因，若<foreach>标签内的SQL没有引用item属性声明的循环变量，而是错误引用了外层的实体对象/全局参数，就会出现所有循环项都取同一个值的问题。比如定义<foreach collection="userList" item="userItem">，但SQL中写的是#{user.id}而非#{userItem.id}，此时会固定取外层user参数的值，若外层变量最终被赋值为列表最后一个元素，就会出现所有行都重复最后一个对象的情况。
• DAO层参数对象复用：如果Java代码中循环复用同一个实体对象，每次仅修改对象属性后调用Mapper方法，MyBatis默认保留参数对象的引用而非拷贝属性值，尤其是使用ExecutorType.BATCH批量执行器时，所有待执行SQL的参数都会指向最后一次修改的对象，最终执行时全是最后一个对象的属性。
• 批量SQL语法拼写错误：比如编写Oracle的MERGE INTO逻辑时，USING后的多行数据拼接错误，没有正确用UNION ALL拼接foreach的每个元素，或是foreach的separator配置错误，导致多组值被错误覆盖。
• Mapper接口集合参数未指定@Param注解：当Mapper方法入参为集合/数组且没有加@Param指定名称时，foreach的collection属性如果配置了自定义名称而非MyBatis默认的list/array，会导致MyBatis无法正确解析集合，取到错误的参数值。

• 修正foreach变量引用：确保foreach内部的所有属性都引用item指定的循环变量，常见场景示例如下：
  • 批量插入场景：

  <insert id="batchInsertUser">
    INSERT INTO user (id, name, age) VALUES
    <foreach collection="userList" item="item" separator=",">
      (#{item.id}, #{item.name}, #{item.age})
    </foreach>
  </insert>
  

  • 批量MERGE场景：

  <update id="batchMergeUser">
    MERGE INTO user t
    USING (
      <foreach collection="userList" item="item" separator="UNION ALL">
        SELECT #{item.id} id, #{item.name} name, #{item.age} age FROM DUAL
      </foreach>
    ) s
    ON (t.id = s.id)
    WHEN MATCHED THEN UPDATE SET t.name = s.name, t.age = s.age
    WHEN NOT MATCHED THEN INSERT (id, name, age) VALUES (s.id, s.name, s.age)
  </update>
  

• 避免参数对象复用：Java层循环调用Mapper方法时，每次循环都创建新的实体对象，不要复用同一个对象实例；如果使用ExecutorType.BATCH批量执行器，可定期调用SqlSession#flushStatements()方法刷新缓存，避免参数引用被覆盖。
• 修正批量SQL语法：确认foreach的separator配置正确，批量插入场景用逗号分隔多个值组，MERGE的多数据源拼接场景用UNION ALL作为分隔符。
• 为Mapper接口的集合参数添加@Param注解：明确指定集合参数的名称，和XML中foreach的collection属性保持一致，示例：

  int batchInsertUser(@Param("userList") List<User> userList);
  

内容的提问来源于stack exchange，提问作者Avi