Java遍历集合报错ConcurrentModificationException的原因分析与解决方法

更新时间：2025年11月07日 09:20:45 作者：网罗开发

这篇文章主要为大家详细介绍了Java遍历集合时报错ConcurrentModificationException的原因分析与对应的解决方法,一共有三种方法,大家可以根据自己的情况进行选择

问题背景：遍历时修改集合

在项目中，我们经常需要对列表进行“边遍历边删除”的操作，比如清理不符合条件的数据：

List<String> users = new ArrayList<>();
users.add("Tom");
users.add("Jerry");
users.add("Spike");

// 删除名字长度小于4的用户
for (String name : users) {
    if (name.length() < 4) {
        users.remove(name); // 报错！
    }
}

运行结果如下：

Exception in thread "main" java.util.ConcurrentModificationException

很多初学者会以为是多线程并发的问题，其实不是——这段代码只有一个线程。真正的原因在于：我们在使用增强 for 循环（底层是 Iterator）遍历时修改了集合结构。

异常原理：fail-fast 机制

Java 的集合类（如 ArrayList、HashMap）在遍历时会维护一个“结构修改计数器（modCount）”。每次调用 add() 或 remove() 时，modCount 都会递增。

而在使用 Iterator 遍历时，迭代器内部也保存了一个 expectedModCount，表示它期望的修改次数。每次 next() 时都会检查：

if (modCount != expectedModCount)
    throw new ConcurrentModificationException();

所以，当你在遍历过程中直接操作原集合（而不是通过迭代器），modCount 会变化，而迭代器的 expectedModCount 没更新，于是触发了“fail-fast”保护机制。

解决方案 1：使用 Iterator.remove()

最正统、最安全的方式就是用 Iterator 自带的 remove() 方法。它会在删除元素的同时同步更新 expectedModCount，从而避免异常。

List<String> users = new ArrayList<>();
users.add("Tom");
users.add("Jerry");
users.add("Spike");

Iterator<String> iterator = users.iterator();
while (iterator.hasNext()) {
    String name = iterator.next();
    if (name.length() < 4) {
        iterator.remove(); // 正确做法
    }
}

System.out.println(users);

输出结果：

[Jerry, Spike]

没有报错，功能正常。

优点：

不会触发 ConcurrentModificationException；
无需复制集合；
对性能影响小。

缺点：

写法略繁琐；
只能在单线程环境中安全使用。

解决方案 2：使用 CopyOnWriteArrayList（线程安全版）

如果你的场景是多线程修改集合，比如在 Web 请求或任务调度中共享数据，可以使用 CopyOnWriteArrayList。

这个类在写操作时会复制底层数组，从而保证读操作不会受写操作影响。

import java.util.concurrent.CopyOnWriteArrayList;

public class Demo {
    public static void main(String[] args) {
        CopyOnWriteArrayList<String> users = new CopyOnWriteArrayList<>();
        users.add("Tom");
        users.add("Jerry");
        users.add("Spike");

        for (String name : users) {
            if (name.length() < 4) {
                users.remove(name); // 不会抛异常
            }
        }

        System.out.println(users);
    }
}

输出：

[Jerry, Spike]

优点：

支持多线程安全修改；
不会触发并发修改异常；
读操作几乎无锁，非常快。

缺点：

写操作开销较大（每次写都会复制整个数组）；
不适合频繁写入的场景。

解决方案 3：Stream 流式重建集合（推荐现代写法）

在 Java 8 之后，其实最推荐的做法是使用 Stream 进行过滤或重建集合。这种写法既优雅又安全，不会破坏原集合。

List<String> users = new ArrayList<>();
users.add("Tom");
users.add("Jerry");
users.add("Spike");

// 使用 Stream 过滤重建集合
users = users.stream()
        .filter(name -> name.length() >= 4)
        .toList(); // 重新生成一个新列表

System.out.println(users);

输出：

[Jerry, Spike]

优点：

不会抛异常；
可读性好；
更符合函数式编程风格；
支持并行流提升性能。

缺点：

会生成新的集合对象（有一定内存开销）。

实际开发场景案例

在一个电商系统中，我们有一个用户购物车 List<CartItem>，每次请求结算时，需要过滤掉失效的商品。

开发者最开始写了这样一段代码：

for (CartItem item : cartItems) {
    if (!item.isValid()) {
        cartItems.remove(item); // 报 ConcurrentModificationException
    }
}

上线后偶发异常。

后来改成：

Iterator<CartItem> iterator = cartItems.iterator();
while (iterator.hasNext()) {
    if (!iterator.next().isValid()) {
        iterator.remove(); // 安全删除
    }
}

或者更现代一点：

cartItems = cartItems.stream()
        .filter(CartItem::isValid)
        .toList(); // 优雅且安全

这样既避免了异常，也让逻辑更清晰。

小结

方案	特点	适用场景
Iterator.remove()	原地删除、安全可靠	单线程遍历
CopyOnWriteArrayList	线程安全、读写分离	多线程读取多、写入少
Stream 过滤重建	优雅简洁、不可变式编程	推荐现代开发风格

结语

ConcurrentModificationException 本质上是 Java 集合为我们提供的一种保护机制，防止在遍历过程中意外修改数据导致不可预期结果。只要理解了它的底层原理——“fail-fast 校验 modCount”，你就能轻松避开这类问题。

简单记一句话：

遍历时不要直接改集合，要么用迭代器，要么重建集合。

到此这篇关于Java遍历集合报错ConcurrentModificationException的原因分析与解决方法的文章就介绍到这了,更多相关Java ConcurrentModificationException异常内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Java基础篇之对象数组练习
对象数组就是数组里的每个元素都是类的对象,赋值时先定义对象,然后将对象直接赋给数组就行了,这篇文章主要给大家介绍了关于Java基础篇之对象数组练习的相关资料,需要的朋友可以参考下
2024-03-03
将Java项目打包为可执行JAR 文件的四种方法
本文主要介绍了Java项目打包为可执行JAR的四种方法,包括IDE配置、Maven/Gradle插件、手动创建及依赖管理,具有一定的参考价值,感兴趣的可以了解一下
2025-08-08
Springboot yml如何获取系统环境变量的值
这篇文章主要介绍了Springboot yml如何获取系统环境变量的值，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-02-02
Spring boot 自定义 Starter及自动配置的方法
Starter 组件是 Spring boot 的一个核心特性，Starter组件的出现极大的简化了项目开发，这篇文章主要介绍了Spring boot 自定义 Starter 及自动配置,需要的朋友可以参考下
2022-12-12
Mybatis拦截器实现数据权限的示例代码
在我们日常开发过程中，通常会涉及到数据权限问题，本文主要介绍了Mybatis拦截器实现数据权限的示例代码，文中通过示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2022-03-03
详解Redis 缓存 + Spring 的集成示例
本篇文章主要介绍了Redis 缓存 + Spring 的集成示例，小编觉得挺不错的，现在分享给大家，也给大家做个参考。一起跟随小编过来看看吧
2017-04-04
MyBatisPlus @TableName表名注解的基本操作
@TableName注解是MyBatis-Plus中用于指定实体类与数据库表映射关系的重要工具,通过使用@TableName注解,可以明确地指定表名,支持多级表名和动态表名,本文给大家介绍MyBatisPlus @TableName表名注解的相关操作,感兴趣的朋友跟随小编一起看看吧
2025-09-09
Mybatis plus结合springboot使用
本文主要介绍了MyBatisPlus使用SpringBoot数据库操作,从添加依赖到测试,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
2024-11-11
java生成验证码图片的方法
这篇文章主要为大家详细介绍了java生成验证码图片的方法，文中示例代码介绍的非常详细，具有一定的参考价值，感兴趣的小伙伴们可以参考一下
2021-02-02
解决java后台登录前后cookie不一致问题
本文主要介绍了java后台登录前后cookie不一致的解决方案，具有很好的参考价值，需要的朋友一起来看下吧
2016-12-12