MyBatis报foreach未声明错误及foreach做Oracle更新是否为最佳实践咨询

你遇到的Element type "foreach" must be declared错误核心原因如下：

• <foreach>是MyBatis 3.x版本才新增的动态SQL标签，如果你当前使用的是旧版iBatis（2.x及更早版本），原生没有该标签，XML解析时识别不到对应元素定义，就会直接抛出SAX解析异常。
• 如果你已经在使用MyBatis 3.x，需要检查Mapper XML头部的DOCTYPE声明是否为MyBatis 3的规范约束，误用iBatis的DTD约束也会导致无法识别<foreach>标签。

1. 适配框架版本的标签修改 #

• 如果你继续使用旧版iBatis，需要替换为iBatis原生的<iterate>标签实现循环逻辑，示例如下：

<update id="updateFG" parameterClass="java.util.Map">
    BEGIN
    <iterate property="entrySet" conjunction=";">
        UPDATE 你的表名
        SET description = #item.value#,
            last_mod_date = SYSDATE
        WHERE name = #item.key#
    </iterate>
    ;END;
</update>

• 如果你使用MyBatis 3.x，先确认XML头部引入了正确的DTD约束：

<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://mybatis.org/dtd/mybatis-3-mapper.dtd">

再修正你的SQL写法，Oracle不支持单次执行多条裸UPDATE语句，需要用PL/SQL块包裹：

<update id="updateFG" parameterType="java.util.Map">
    BEGIN
    <foreach collection="entrySet" item="item" separator=";">
        UPDATE 你的表名
        SET description = #{item.value},
            last_mod_date = SYSDATE
        WHERE name = #{item.key}
    </foreach>
    ;END;
</update>

你当前的循环生成多条UPDATE的写法不属于Oracle场景下的最佳实践，存在明显缺陷：

• 数据量大时会产生N次数据库交互请求，性能损耗极高，事务持锁时间也会变长，容易引发锁等待问题。
• 多语句执行依赖额外的数据库适配配置，兼容性差。

Oracle场景下批量更新更推荐使用MERGE INTO语法，单次数据库交互即可完成所有更新，性能提升显著，示例如下：

<update id="updateFG" parameterType="java.util.Map">
    MERGE INTO 你的表名 t
    USING (
        <foreach collection="entrySet" item="item" separator="UNION ALL">
            SELECT #{item.key} name, #{item.value} description FROM DUAL
        </foreach>
    ) s
    ON (t.name = s.name)
    WHEN MATCHED THEN UPDATE SET t.description = s.description, t.last_mod_date = SYSDATE
</update>

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