Java遍历Map安全删除元素技巧

Java中遍历Map时安全删除元素的正确方式是使用Iterator的remove()方法或Java 8+的removeIf()；必须通过entrySet().iterator()获取迭代器并调用其remove()，不可调用Map自身的remove()，否则抛ConcurrentModificationException。

在Java中遍历Map时直接调用remove()会抛出ConcurrentModificationException，因为普通遍历（如增强for循环或keySet迭代）不支持边遍历边修改。安全删除的关键是使用Iterator的remove()方法，或改用支持并发修改的集合类型。

使用Iterator的remove()方法（最常用）

这是标准、线程不安全但语义清晰的安全方式。必须通过迭代器自身的方法删除，不能调用Map的remove()。

• 获取entrySet().iterator()，而非keySet()或values()的迭代器（避免类型转换或无法访问键值对）
• 在next()之后、下一次next()之前调用remove()，且每个remove()只能对应一次next()
• 示例：

Map<String, Integer> map = new HashMap<>();
map.put("a", 1);
map.put("b", 2);
map.put("c", 3);

Iterator<Map.Entry<String, Integer>> iter = map.entrySet().iterator();
while (iter.hasNext()) {
    Map.Entry<String, Integer> entry = iter.next();
    if (entry.getValue() < 2) {
        iter.remove(); // ✅ 安全
    }
}
// 结果：map = {"b"=2, "c"=3}

使用removeIf()（Java 8+，简洁推荐）

Map本身没有removeIf()，但可对keySet()或entrySet()调用（它们继承自Collection）。

• 对entrySet()调用更直观，能同时访问键和值
• 内部仍基于Iterator实现，线程不安全，但代码更简洁
• 示例：

map.entrySet().removeIf(entry -> entry.getValue() < 2);
// 等价于上面的Iterator写法，一行搞定

并发场景：用ConcurrentHashMap

若需多线程环境下边遍历边删除，优先考虑ConcurrentHashMap。它允许部分并发修改，但注意：

• ConcurrentHashMap的迭代器是弱一致性的（weakly consistent），不会抛CME，但可能不反映最新修改
• 仍建议用removeIf()或computeIfPresent()等原子方法，而非手动遍历+remove
• 避免用keySet().iterator()后调map.remove()——这仍可能出问题

不推荐的方式（易踩坑）

以下做法看似可行，实则危险或低效：

• 先收集待删key，遍历完再批量remove()：内存开销大，且两次遍历效率低
• 用增强for循环+map.remove(key)：必定触发ConcurrentModificationException
• 用forEach() + remove()：Lambda中调用Map的remove()同样非法
• 用TreeMap的subMap().clear()等：仅适用于特定范围删除，通用性差

基本上就这些。核心就一条：遍历时删元素，只认Iterator.remove()或它的封装（如removeIf）。其他路子，不是报错就是埋雷。