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 为例:
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式,或要求按照代码注释规范处理 Java 文件时,使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则,并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括:补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 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)或加锁控制
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










