fail-fast本质是用modCount与expectedModCount的版本号校验检测非法修改,非同步机制;触发需同时满足:迭代中调用next()/hasNext(),且集合被add/remove等结构性修改,set()或读操作不触发。

Java Iterator 的 fail-fast 机制在多线程环境下,本质是**用“版本号校验”来检测非法并发修改**,不是真正防止修改,而是第一时间发现并中断错误遍历。
fail-fast 触发的核心条件
必须同时满足以下两点才会抛出 ConcurrentModificationException:
- 一个线程正在用 Iterator 遍历集合(调用
hasNext()或next()) - 另一个线程(或同一线程的其他代码)通过集合自身的方法(如
add()、remove()、clear())做了结构性修改
注意:set() 替换已有元素、或仅读取操作(如 get()、contains())不会改变 modCount,因此不触发 fail-fast。
底层靠两个关键变量协同判断
以 ArrayList 为例:
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
立即学习“Java免费学习笔记(深入)”;
-
modCount:定义在AbstractList中,是集合的“修改计数器”。每次 add/remove/clear 等结构性操作后自动 +1 -
expectedModCount:Iterator 实例内部字段,在创建迭代器时被初始化为当时的modCount值
每次调用 next() 或 hasNext() 前,都会执行类似这样的检查:
if (modCount != expectedModCount)
throw new ConcurrentModificationException();
}
多线程下为什么容易触发?
因为 modCount 是非 volatile 的普通字段,没有同步保护。典型场景如下:
- 线程 A 创建 Iterator,读取到
expectedModCount = 3 - 线程 B 调用
list.add(...)→modCount变成 4 - 线程 A 再次调用
next()→ 检查失败 → 抛异常
这个过程不依赖锁或内存屏障,纯粹靠数值比对,所以轻量但“不保证 100% 捕获”——JDK 明确说明 fail-fast 是一种尽力而为的检测机制,不是线程安全的替代方案。
常见误区澄清
-
不是所有修改都触发:只响应结构性修改(影响 size 或内部数组结构),
set(index, e)不算 -
单线程也会触发:比如 for-each 循环中直接调用
list.remove(),和多线程无关 -
Vector 也是 fail-fast:虽然它的方法加了
synchronized,但其 Iterator 仍检查modCount,未做额外同步 -
异常不是“并发问题”的解决,而是提示:它告诉你当前遍历已不可靠,应改用线程安全集合(如
CopyOnWriteArrayList)或加锁控制

















