LinkedList 的 modCount 在结构性修改时自增,包括 add、remove、clear 及批量操作;遍历时若外部修改导致 modCount 变化,迭代器校验失败即抛 ConcurrentModificationException。

Java 中 fail-fast 机制在 LinkedList 遍历时的 modCount 自增逻辑,和 ArrayList 原理一致,但触发时机和底层结构细节不同。核心仍是:迭代器创建时记录 expectedModCount = modCount,每次调用 next() 或 remove() 前校验二者是否相等;不等则抛 ConcurrentModificationException。
modCount 在 LinkedList 中何时自增?
modCount 是 AbstractList 定义的 transient int 字段,LinkedList 继承后直接使用。它只在结构性修改时递增 —— 即改变链表大小或节点连接关系的操作:
-
add(E e)、add(int index, E element):新增节点,size 变、prev/next 引用更新 →modCount++ -
remove(Object o)、remove(int index):删除节点,断开前后链接 →modCount++ -
clear():清空所有节点 →modCount++ -
addAll(...)、removeAll(...)、retainAll(...):批量结构性变更 →modCount累加(每轮 add/remove 各加 1) -
注意:
get(int index)、set(int index, E element)不改变链表结构,不触发modCount自增
遍历中触发异常的关键路径
以增强 for 循环或显式 Iterator 遍历为例,异常发生在迭代器内部的 checkForComodification() 调用点:
- 创建
LinkedList.iterator()时,内部ListItr类将当前modCount赋给expectedModCount - 每次
next()执行前,先调用checkForComodification() - 若此时外部代码(同一线程或其它线程)已调用
linkLast()、unlink()等方法导致modCount变更,校验失败 → 立即抛异常 - 即使单线程下边遍历边调用
list.remove(x)(非iterator.remove()),也会触发
为什么 LinkedList 的 fail-fast 更易被忽略?
相比 ArrayList 的数组拷贝扩容,LinkedList 的结构性修改更“隐蔽”,但 modCount 依然严格维护:
立即学习“Java免费学习笔记(深入)”;
- 插入/删除都在链表中间或首尾进行,看似轻量,但每个操作都涉及节点指针重连 → 属于结构性修改 → 必然
modCount++ - 例如
linkLast(e)方法内:更新last指针、设置新节点prev、可能更新first→ 全部完成后才执行modCount++ - 多线程环境下,
modCount的可见性无保障(未用volatile),但 fail-fast 本就不保证 100% 检测,它的目标是“大概率暴露问题”,而非强同步
安全修改的正确方式
避免异常,关键在于让修改动作由迭代器自身控制,而非集合对象:
- 遍历时要用
iterator.remove(),它会同步更新expectedModCount,保持与modCount一致 - 需要添加元素?不能用
list.add(),可先收集待添加项,遍历结束后统一 add - 多线程场景下,改用线程安全替代品:
CopyOnWriteArrayList(适合读多写少)、ConcurrentLinkedDeque(无 fail-fast,弱一致性) - 若必须用 LinkedList 且需并发修改,加外部锁(如
synchronized(list)),但会牺牲并发性能


















