Java 中遍历 Map 时为何禁止修改原 Map？正确批量更新方案详解

今天我们来聊一个在 Ja va 开发中非常容易踩的坑：遍历 Map 的时候，能不能对原 Map 做增删操作？很多初学者（甚至有些老手）都会在这里翻车。

先给出最直接的结论——Ja va 官方明确禁止在遍历 Map 时直接调用 put()、remove() 这种会改变 Map 本身结构的操作。一旦这么做了，后续迭代器和 Map.Entry 的行为都会变得不可预测。唯一被规范允许的“遍历中修改”方式，是通过 Map.Entry.setValue() 来更新当前条目的值。当然，你也可以换用线程安全或支持并发修改的策略来规避这个问题。

问题出在哪里？其实根子在 Map.entrySet() 返回的那个 Set> 上。它是一个弱一致性视图（weakly consistent view），简单说就是它底层直接引用着原 Map 的数据结构。遍历过程中，一旦原 Map 的结构发生变动（比如新增键、删除键），就会引发两类未定义行为：

• Map.Entry 实例失效：官方文档里写得很清楚，Map.Entry 对象只在当前的迭代周期内有效。如果 Map 在遍历过程中被修改了（setValue() 除外），之后再访问这个 Entry 的 getKey()、getValue()，或者再次调用 setValue()，结果都是不确定的。
• 迭代器行为崩溃：最典型的后果就是 ConcurrentModificationException 直接抛出。如果是 ConcurrentHashMap 这种非 fail-fast 的实现，虽然不抛异常，但可能会静默地返回脏数据，或者遍历顺序、元素数量完全乱掉，甚至循环能不能完整走完都是个问题。

想想看，这本身就是一种设计上的安全约束，但很多人还是会在不经意间踩进去。

❌ 常见错误示例（绝对禁止）

比如下面这种写法，看着好像没什么问题，但完全是定时冲击波：

Map map = new HashMap<>(Map.of("a", 1, "b", 2));
for (Map.Entry entry : map.entrySet()) {
    map.put("c", 3); // ⚠️ 危险！修改原 Map → Entry 和 Iterator 行为未定义
    map.remove("a"); // ⚠️ 同样危险
}

顺便提一句：entry.put(...) 这种写法根本无法通过编译，因为 Map.Entry 接口根本没有提供 put() 方法。这其实也算是类型安全的第一道防线。

那么，到底该怎么办呢？下面这几个方案，按场景选就行。

✅ 安全的批量更新方案

方案 1：使用 setValue() 就地更新值（推荐用于纯 value 修改）

如果你的需求只是修改某些 key 对应的 value，而不涉及增删 key，那直接用 setValue() 是最优雅、最高效的：

Map map = new HashMap<>(Map.of("a", 10, "b", 20));
for (Map.Entry entry : map.entrySet()) {
    entry.setValue(entry.getValue() * 2); // ✅ 合法：仅修改当前 Entry 的 value
}
// 结果：{"a"=20, "b"=40}

✅ 优势：零额外内存开销，O(1) 时间复杂度，完全符合规范。
⚠️ 限制：仅适用于更新 value，不能增删 key 或改变 Map 结构。

方案 2：收集待修改项，遍历结束后批量操作

如果需要增删 key，那就先把要操作的对象记录下来，等遍历完再统一执行：

Map map = new HashMap<>(Map.of("a", 1, "b", 2));
List keysToRemove = new ArrayList<>();
Map entriesToAdd = new HashMap<>();

for (Map.Entry entry : map.entrySet()) {
    if (entry.getValue() < 5) {
        keysToRemove.add(entry.getKey());
    }
    if ("a".equals(entry.getKey())) {
        entriesToAdd.put("newKey", 999);
    }
}

// 安全地批量修改（不在迭代中）
keysToRemove.forEach(map::remove);
map.putAll(entriesToAdd);

方案 3：使用 ConcurrentHashMap + replaceAll()（高并发场景）

多线程环境下的最佳选择：

ConcurrentHashMap concurrentMap = 
    new ConcurrentHashMap<>(Map.of("a", 1, "b", 2));
concurrentMap.replaceAll((k, v) -> k.equals("a") ? v * 10 : v); // ✅ 线程安全且原子

方案 4：流式处理（创建新 Map，函数式风格）

如果你更偏爱函数式编程，或者需要生成一个全新的 Map：

Map original = Map.of("a", 1, "b", 2);
Map updated = original.entrySet().stream()
    .collect(Collectors.toMap(
        Map.Entry::getKey,
        e -> e.getValue() + 100 // 自定义转换逻辑
    ));

⚠️ 关键注意事项总结

• 永远不要在 for-each 或 Iterator 遍历中调用原 Map 的 put()/remove()；
• Map.Entry.setValue() 是唯一被规范允许的“遍历中修改”操作；
• 若需动态增删 key，请先缓存操作指令，遍历完成后再执行；
• 多线程环境下，优先选用 ConcurrentHashMap 并配合其专用方法（如 computeIfPresent）；
• 使用 forEach() 或 Stream 操作时，同样受上述规则约束——它们本质仍是基于 entrySet().iterator()。

遵循这些原则，你就能在保证代码健壮性和可维护性的前提下，高效、安全地完成 Map 的批量更新任务。