Java报ConcurrentModificationException的排查方法(for-each遍历删除、modCount与Iterator.remove、removeIf定位)

遍历一个List时按条件删元素,控制台抛出Exception in thread "main" java.util.ConcurrentModificationException,堆栈指向ArrayList$Itr.checkForComodification。代码里明明只有一个线程,报的却是并发修改,这个名字骗过不少人。真正的原因是for-each循环背后编译器替代码创建了一个Iterator,循环体里直接调了list.remove(),迭代器下一次next()发现集合被动过就当场抛异常。

Exception in thread "main" java.util.ConcurrentModificationException
    at java.base/java.util.ArrayList$Itr.checkForComodification(ArrayList.java:1104)
    at java.base/java.util.ArrayList$Itr.next(ArrayList.java:1058)
    at com.example.OrderCleaner.main(OrderCleaner.java:24)

这个报错在单线程里遇到过不止一次,跟线程安全没多大关系。


1、先弄清modCount在查什么

ArrayList、HashMap、HashSet这些集合内部有个int字段modCount,只要发生结构性修改(add、remove、clear,或者HashMap扩容rehash)就加一;set改已有元素的值不算。调用iterator()时,新建的Itr把当时的modCount抄进expectedModCount。每次next()先跑checkForComodification(),比对两个数不等就抛ConcurrentModificationException。hasNext()只是判断游标有没有走到size,压根不比对,所以异常总是落在next()那一行,而不是remove()那一行。

for-each写起来干净,编译出来就是这套Iterator,代码里看不见迭代器,异常照样来。这套设计叫fail-fast,是尽力而为的检测,不算线程安全保证。


2、有个不抛异常的坑要单独记住

列表里只有两个元素、删掉第一个时,循环反而不报错:remove之后size从2变1,cursor也正好是1,hasNext()返回false,next()再没机会执行,那个数就没人比对。结果是列表剩下[b],b从头到尾没被遍历到,代码看着跑通了,其实漏了一个元素。之前接手过一段清理逻辑,测试数据刚好是偶数条,线上换成奇数条才炸出来,查了半天才定位到是这个静默跳过。别用try/catch把异常吞掉当修复,抛出来反而是好事。


3、单线程下改集合的四种写法

最省事的是把删除交给迭代器自己,it.remove()会同步更新expectedModCount,注意调的是迭代器的方法而不是list.remove():

Iterator<String> it = list.iterator();
while (it.hasNext()) {
    String s = it.next();
    if (s.isEmpty()) {
        it.remove();
    }
}

Java 8给Collection接口加了默认方法removeIf,一行搞定,ArrayList上它单趟压缩,删k个元素是O(n),比反复remove(i)的O(n·k)省得多,实测十几万条数据差别很明显:

list.removeIf(s -> s.isEmpty());

倒序的索引for循环也不会触发,因为删掉元素后尚未访问的下标不往前挪,迭代器那套机制根本没参与。循环体里要顺带记日志、发消息这类有副作用的动作,就别塞进removeIf的谓词,改成遍历一份副本,或者先把要删的攒进toRemove,循环结束再list.removeAll(toRemove)。

Map上的写法是同一套,只是换成entrySet().removeIf()或者显式拿entrySet().iterator()再调it.remove();keySet()、values()的视图也都能removeIf。


4、真多线程才换并发容器

上面那些都是单线程改集合。要是确实有多个线程同时读写,方向完全不同:CopyOnWriteArrayList每次写都复制一份底层数组,迭代器走的是快照,不会抛,代价是写多时复制开销大,适合读多写少;ConcurrentHashMap给的是弱一致性迭代器,遍历期间别的线程改了不抛也不保证全看到;Collections.synchronizedList()只包装了单个方法,遍历时仍要自己套synchronized (list),漏了照样抛。之前见过有人仅仅为了躲掉这个异常就把ArrayList换成CopyOnWriteArrayList,写频繁的队列内存涨得厉害,属于没对上症状。

JDK 1.4.2、1.5.0、1.6.0、1.7.0、1.8.0,这些版本里modCount与checkForComodification的位置没挪过,2026年翻OpenJDK源码还是next()里那一行比对;CopyOnWriteArrayList是1.5.0随java.util.concurrent进来的,removeIf到1.8.0才有。手头几台机器从老项目到新服务都验证过,报错文本和四种改法一致,数据截至2026年11月。

按单线程还是真并发先分个类,再选改法,比一上来就换容器省事。