Java集合迭代时直接修改会抛ConcurrentModificationException,因fail-fast机制通过modCount与expectedModCount校验实现;安全方式包括Iterator.remove()、ListIterator增删改、批量处理或使用线程安全集合。

在 Java 中,对集合进行迭代时直接修改元素(如添加、删除或清空集合),会触发 ConcurrentModificationException。这不是因为多线程并发导致的,而是 Java 集合类(如 ArrayList、HashMap、HashSet 等)内置了快速失败(fail-fast)机制——通过维护一个 modCount(修改计数器)来检测结构被意外修改。
为什么迭代中修改会抛异常?
每次调用 iterator() 创建迭代器时,迭代器会记录当前集合的 modCount 值(记为 expectedModCount)。之后每次调用 next() 或 hasNext(),都会检查 modCount == expectedModCount。一旦集合结构被外部修改(比如调用 list.remove(obj)、list.add()、map.put() 等),modCount 自增,但迭代器里的 expectedModCount 没变,校验失败即抛出 ConcurrentModificationException。
哪些操作会触发该异常?
以下是在 for-each 循环 或 显式 Iterator 迭代过程中,直接调用集合自身方法修改结构的行为:
-
list.remove(element)或list.add(element) -
set.remove(element)或set.add(element) -
map.put(key, value)、map.remove(key)(注意:map.keySet().remove()同样危险) collection.clear()
安全修改的正确方式有哪些?
关键原则是:**必须通过迭代器本身提供的方法修改,而非集合对象**。
-
使用
Iterator.remove()—— 这是唯一被允许的删除方式:Iterator<string> it = list.iterator();<br>while (it.hasNext()) {<br> String s = it.next();<br> if (s.startsWith("A")) it.remove(); // ✅ 安全}</string> -
使用
ListIterator进行增删改(仅限 List):ListIterator<string> lit = list.listIterator();<br>while (lit.hasNext()) {<br> String s = lit.next();<br> if (s.length() > 5) lit.set("short"); // ✅ 替换<br> if (s.contains("x")) lit.add("new"); // ✅ 插入<br>}</string> -
收集待操作元素,迭代结束后批量处理:
先遍历存入临时集合(如toRemove),再调用list.removeAll(toRemove);适合需多次判断/复杂逻辑的场景。 -
使用线程安全集合(如
CopyOnWriteArrayList、ConcurrentHashMap):
它们不依赖modCount,支持迭代中修改(但要注意语义差异:例如CopyOnWriteArrayList.iterator()返回的是快照,后续修改不影响当前迭代)。
特别注意的“伪安全”写法
以下看似合理,实则仍会抛异常:
for (int i = 0; i —— 索引错位 +modCount不匹配-
for (String s : list) { list.remove(s); }—— for-each 底层仍是 Iterator,等价于直接调集合 remove -
map.entrySet().forEach(entry -> map.remove(entry.getKey()));—— 同样触发 fail-fast
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











