MyBatis中Map类型在foreach循环未出现键值对混乱，是否始终可靠？

你的写法存在数据错位风险，无法保证数据始终正确插入，核心原因如下：

• Map本身是无序集合，虽然JDK 8及以上的HashMap会保留插入顺序，但这是JDK实现细节，并非Java规范强制要求。一旦更换Map实现（比如Hashtable）、升级JDK版本，或是业务中对Map做了修改（如重复put元素），keySet()和values()的遍历顺序就可能脱节，导致列名与对应的值错位。
• 你测试100次没问题只是巧合，依赖这种非规范行为会埋下线上故障隐患。

可行的修正方案 #

方案1：用LinkedHashMap保证顺序 #

如果必须用Map传参，确保传入LinkedHashMap，它会严格维护插入顺序，让keySet()和values()的遍历顺序完全对应：

// 调用接口时传入LinkedHashMap
Map<String, Object> map = new LinkedHashMap<>();
map.put("aa", "11");
map.put("bb", "22");
mapper.insertHT(map);

XML代码可保持不变，但要确保所有调用方都传入LinkedHashMap。

方案2：改用实体类传参（推荐） #

这是最稳妥的方式，既避免Map顺序问题，又提升代码可读性：

1. 定义对应表的实体类：

public class AaEntity {
    private String aa;
    private String bb;
    // 省略getter、setter方法
}

2. 修改Mapper接口：

int insertHT(AaEntity entity);

3. 修改XML代码：

insert into AA (aa, bb)
values (#{aa}, #{bb})

字段较多时，还可以利用MyBatis自动映射简化写法。

方案3：用Map.Entry的List传递键值对 #

把键值对封装成List<Map.Entry>，直接遍历生成SQL，彻底规避顺序问题：

1. 修改Mapper接口：

int insertHT(@Param("entries") List<Map.Entry<String, Object>> entries);

2. 修改XML代码：

insert into AA
<foreach collection="entries" item="entry" separator="," open="(" close=")">
    ${entry.key}
</foreach>
values
<foreach collection="entries" item="entry" separator="," open="(" close=")">
    #{entry.value}
</foreach>

调用时将Map转成entry列表即可：new ArrayList<>(map.entrySet())

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