遍历Map时操作行为未定义？如何批量更新Map条目？

关于Map.Entry，Java文档说明如下：

Map条目（键值对）。Map.entrySet方法返回该Map的集合视图，其元素属于此类。获取Map条目的引用的唯一方式是通过该集合视图的迭代器。这些Map.Entry对象仅在迭代期间有效；更正式地说，如果在条目被迭代器返回后，底层Map被修改（除非通过该Map条目的setValue操作），则该Map条目的行为是未定义的。

这段说明的核心是：遍历Map的entrySet时，禁止对底层Map执行结构性修改（比如put()、remove()、clear()这类改变Map元素数量的操作），但通过Map.Entry.setValue()修改条目值是安全的。针对批量更新需求，有以下几种可靠方案：

1. 直接通过Map.Entry.setValue()修改值（无结构性修改场景） #

如果只是需要更新现有键对应的值，不需要新增或删除键，直接遍历entrySet并调用setValue()是最合规的方式：

for (Map.Entry<String, Integer> entry : scoreMap.entrySet()) {
    // 示例：将所有分数加10
    entry.setValue(entry.getValue() + 10);
}

这种方式完全符合文档要求，不会触发未定义行为。

2. 借助临时Map实现全量更新（含结构性修改场景） #

如果需要在更新过程中新增键、删除键，或者无法直接修改原Map的引用，可先将处理后的键值对存入临时Map，再同步到原Map：

Map<String, Integer> updatedScoreMap = new HashMap<>();
for (Map.Entry<String, Integer> entry : scoreMap.entrySet()) {
    // 示例：保留分数≥60的条目，并加5分
    if (entry.getValue() >= 60) {
        updatedScoreMap.put(entry.getKey(), entry.getValue() + 5);
    }
    // 可在此处添加新键值对
    updatedScoreMap.put("newStudent", 80);
}

// 方式1：直接替换原Map引用
scoreMap = updatedScoreMap;

// 方式2：清空原Map后批量导入（适用于无法替换引用的场景）
scoreMap.clear();
scoreMap.putAll(updatedScoreMap);

3. 使用迭代器安全删除+更新（需删除条目场景） #

如果遍历过程中需要删除部分条目，同时更新其他条目，必须使用迭代器的remove()方法（而非直接调用Map的remove()），搭配setValue()完成操作：

Iterator<Map.Entry<String, Integer>> iterator = scoreMap.entrySet().iterator();
while (iterator.hasNext()) {
    Map.Entry<String, Integer> entry = iterator.next();
    if (entry.getValue() < 60) {
        // 安全删除不及格条目
        iterator.remove();
    } else {
        // 更新及格条目的分数
        entry.setValue(entry.getValue() + 5);
    }
}

关键说明 #

文档中提到的“底层Map被修改”特指结构性修改（即改变Map中键的数量的操作），setValue()仅修改已有键对应的值，不属于结构性修改，因此是被允许的安全操作。

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