java 规范明确禁止在遍历 map 的同时直接调用 put/remove 等结构性修改方法，否则迭代器和 map.entry 行为将变为未定义；但可通过 entry.setvalue() 安全更新值，或借助临时集合、replaceall()、stream() 等方式实现批量更新。
java 规范明确禁止在遍历 map 的同时直接调用 put/remove 等结构性修改方法，否则迭代器和 map.entry 行为将变为未定义；但可通过 entry.setvalue() 安全更新值，或借助临时集合、replaceall()、stream() 等方式实现批量更新。
在 Java 中，Map.entrySet() 返回的 Set
✅ 安全操作：仅允许 setValue()
Map.Entry 接口唯一被明确授权的修改操作是 setValue(V value)，它可安全更新当前条目的值，且保证线程安全（对支持并发的 Map 如 ConcurrentHashMap 也适用）：
Map<String, Integer> map = new HashMap<>(Map.of("x", 10, "y", 20));
for (Map.Entry<String, Integer> entry : map.entrySet()) {
entry.setValue(entry.getValue() * 2); // ✅ 合法：仅修改值
}
// 结果：{"x"=20, "y"=40}⚠️ 注意：setValue() 不允许修改键（key），也不能新增或删除条目。
❌ 危险操作：禁止在遍历时修改原 Map
以下写法绝对禁止，会导致未定义行为：
立即学习“Java免费学习笔记（深入）”；
Map<String, String> map = new HashMap<>(Map.of("a", "old"));
for (Map.Entry<String, String> e : map.entrySet()) {
map.put("b", "new"); // ❌ 危险！修改了正在迭代的 map
System.out.println(e.getKey()); // e 的行为已不可预测
}即使看似“只读”地访问 e.getKey() 或 e.getValue()，只要 map 已被修改，后续对 e 的任何调用（包括 getKey()）都可能抛异常或返回错误结果。
✅ 推荐的批量更新方案
方案 1：收集后批量操作（最通用）
先收集待更新的键或新条目，再统一处理：
Map<String, Integer> map = new HashMap<>(Map.of("a", 1, "b", 2));
List<String> keysToRemove = new ArrayList<>();
Map<String, Integer> updates = new HashMap<>();
for (Map.Entry<String, Integer> e : map.entrySet()) {
if (e.getValue() < 5) {
keysToRemove.add(e.getKey());
} else {
updates.put(e.getKey(), e.getValue() + 10);
}
}
// 批量移除与更新（安全，非迭代中修改）
keysToRemove.forEach(map::remove);
map.putAll(updates);方案 2：使用 replaceAll()（JDK 8+，简洁高效）
专为批量值更新设计，内部已规避并发问题：
Map<String, Integer> map = new HashMap<>(Map.of("a", 1, "b", 2));
map.replaceAll((k, v) -> v * 3); // ✅ 线程安全，语义清晰
// 结果：{"a"=3, "b"=6}方案 3：Stream + Collector（函数式风格）
适用于复杂转换逻辑，生成新 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
));方案 4：使用 Iterator.remove() 删除条目
若需边遍历边删除，必须使用 Iterator 的 remove() 方法：
Iterator<Map.Entry<String, Integer>> it = map.entrySet().iterator();
while (it.hasNext()) {
Map.Entry<String, Integer> e = it.next();
if (e.getValue() == 0) {
it.remove(); // ✅ 唯一安全的删除方式
}
}总结
- 核心原则：遍历 entrySet() 时，map 是只读上下文；唯一例外是 entry.setValue()。
- 避免陷阱：不要在 for-each 循环体内调用 map.put() / map.remove()。
- 选对工具：值更新优先用 replaceAll()；增删改混合逻辑用“收集+批量操作”；追求不可变性则用 Stream。
- 并发场景：若需多线程安全遍历与修改，请选用 ConcurrentHashMap 并配合其专用 API（如 computeIfPresent）。
遵循这些实践，即可在保障程序健壮性的前提下，高效完成 Map 的批量更新任务。
