Java 遍历 Map 时禁止直接调用 put/remove 等结构性修改方法，否则会导致迭代器行为未定义；但可通过 Map.Entry.setValue() 安全更新值，或改用批量收集+重建、replaceAll()、computeIfPresent() 等线程安全方式实现批量更新。
java 遍历 map 时禁止直接调用 put/remove 等结构性修改方法，否则会导致迭代器行为未定义；但可通过 `map.entry.setvalue()` 安全更新值，或改用批量收集+重建、`replaceall()`、`computeifpresent()` 等线程安全方式实现批量更新。
在 Java 中，Map.entrySet() 返回的是一个集合视图（collection view），其迭代过程本质上是“快照式”的——它不隔离底层 Map 的并发修改。官方文档明确指出：在迭代过程中，若通过非受控方式修改原 Map（如调用 put()、remove()、clear()），则不仅当前 Map.Entry 对象的行为变为未定义，整个迭代器的结果也失去保障（可能抛出 ConcurrentModificationException，也可能静默失败或返回脏数据）。
❌ 常见错误：边遍历边结构性修改
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
System.out.println(entry.getKey()); // entry 行为已未定义，结果不可靠
}</string></string>
该代码虽能编译，但运行时极可能触发 ConcurrentModificationException（尤其在 HashMap 的 fail-fast 实现中），且即使未抛异常，entry 的 getKey()/getValue() 也可能返回过期或不一致状态。
? 注意：Map.Entry 本身没有 put() 方法——这是常见误解。entry.put(...) 根本无法编译，因为 Map.Entry 是只读键值对接口，仅提供 getKey()、getValue() 和 setValue()。
✅ 正确做法一：使用 setValue() 安全更新值
Map.Entry.setValue() 是唯一被明确认可的“迭代中修改”操作，它会同步更新原 Map 中对应键的值：
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); // ✅ 合法：将所有值翻倍
}
// 结果：{"a"=20, "b"=40}</string></string>
此操作不会破坏迭代器结构，也不会引发 ConcurrentModificationException。
✅ 正确做法二：批量更新推荐方案（更清晰、更安全）
对于复杂逻辑（如条件更新、键值同时变更、或需新增/删除条目），应避免在循环中修改原 Map，转而采用以下工业级实践：
方案 1：收集变更 → 批量应用（推荐用于复杂逻辑）
Map<string integer> map = new HashMap(Map.of("a", 1, "b", 2, "c", 3));
List<map.entry integer>> toUpdate = new ArrayList();
List<string> toRemove = new ArrayList();
// 第一遍：扫描并记录意图
for (Map.Entry<string integer> e : map.entrySet()) {
if (e.getValue() map.put(e.getKey(), e.getValue()));
toRemove.forEach(map::remove);</string></string></map.entry></string>
方案 2：使用 replaceAll()（简洁值更新）
map.replaceAll((key, oldValue) -> oldValue * 2); // 所有值 ×2
方案 3：使用 computeIfPresent() / merge()（条件更新）
map.computeIfPresent("a", (k, v) -> v + 100); // 仅当 key 存在时更新
map.merge("d", 50, Integer::sum); // 若 key 不存在则 put，存在则聚合
✅ 补充说明：跨 Map 操作是安全的
修改其他 Map 不会影响当前迭代：
Map<string string> src = Map.of("x", "1");
Map<string string> dst = new HashMap();
for (Map.Entry<string string> e : src.entrySet()) {
dst.put(e.getKey(), e.getValue().toUpperCase()); // ✅ 完全合法
}</string></string></string>
总结
- 禁止：遍历时调用 map.put()/remove()/clear() 等结构性方法；
- 允许：仅 entry.setValue() 可安全更新当前条目的值；
- 推荐：对批量更新需求，优先使用 replaceAll()、compute*() 系列方法，或采用“扫描+收集+批量提交”两阶段模式；
- 本质原因：entrySet() 视图与原 Map 共享结构，fail-fast 机制旨在及早暴露并发修改风险，而非提供线程安全保证。如需真正并发安全，请选用 ConcurrentHashMap 并配合其专用 API（如 forEach()、replace()）。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
