Java 规范明确禁止在遍历 Map 时直接调用 put()、remove() 等结构性修改方法，否则迭代器和 Map.Entry 行为未定义；唯一安全的就地更新方式是通过 Map.Entry.setValue() 修改值，或改用线程安全/支持并发修改的策略。
java 规范明确禁止在遍历 map 时直接调用 `put()`、`remove()` 等结构性修改方法，否则迭代器和 map.entry 行为未定义；唯一安全的就地更新方式是通过 `map.entry.setvalue()` 修改值，或改用线程安全/支持并发修改的策略。
在 Java 中，Map.entrySet() 返回的 Set
- Map.Entry 实例失效：文档明确指出，Map.Entry 对象仅在当前迭代周期内有效；若 Map 被修改（setValue() 除外），后续访问该 Entry 的 getKey()、getValue() 或再次调用 setValue() 的行为均未定义；
- 迭代器行为崩溃：Iterator 可能抛出 ConcurrentModificationException（非 fail-fast 实现如 ConcurrentHashMap 则可能静默失败或返回脏数据），且遍历顺序、元素数量、甚至是否完成循环均不可预测。
❌ 常见错误示例（绝对禁止）
Map<String, Integer> map = new HashMap<>(Map.of("a", 1, "b", 2));
for (Map.Entry<String, Integer> entry : map.entrySet()) {
map.put("c", 3); // ⚠️ 危险！修改原 Map → Entry 和 Iterator 行为未定义
map.remove("a"); // ⚠️ 同样危险
}? 提示：entry.put(...) 根本无法编译——Map.Entry 接口不提供 put() 方法，这是类型安全的第一道防线。
✅ 安全的批量更新方案
方案 1：使用 setValue() 就地更新值（推荐用于纯 value 修改）
Map<String, Integer> map = new HashMap<>(Map.of("a", 10, "b", 20));
for (Map.Entry<String, Integer> entry : map.entrySet()) {
entry.setValue(entry.getValue() * 2); // ✅ 合法：仅修改当前 Entry 的 value
}
// 结果：{"a"=20, "b"=40}✅ 优势：零额外内存开销，O(1) 时间复杂度，完全符合规范。
⚠️ 限制：仅适用于更新 value，不能增删 key 或改变 Map 结构。
方案 2：收集待修改项，遍历结束后批量操作
Map<String, Integer> map = new HashMap<>(Map.of("a", 1, "b", 2));
List<String> keysToRemove = new ArrayList<>();
Map<String, Integer> entriesToAdd = new HashMap<>();
for (Map.Entry<String, Integer> 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<String, Integer> concurrentMap =
new ConcurrentHashMap<>(Map.of("a", 1, "b", 2));
concurrentMap.replaceAll((k, v) -> k.equals("a") ? v * 10 : v); // ✅ 线程安全且原子方案 4：流式处理（创建新 Map，函数式风格）
Map<String, Integer> original = Map.of("a", 1, "b", 2);
Map<String, Integer> 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 的批量更新任务。
