脚本之家 服务器常用软件
快捷导航
您的位置：首页 → 软件编程 → java → Java ConcurrentModificationException异常

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 notify和notifyAll的对比

    java notify和notifyAll的对比

    这篇文章主要介绍了 java notify和notifyAll的对比的相关资料,需要的朋友可以参考下
    2017-02-02
  • java.lang.Void 与 void的比较及使用方法介绍

    java.lang.Void 与 void的比较及使用方法介绍

    这篇文章主要介绍了java.lang.Void 与 void的比较及使用方法介绍，小编觉得挺不错的，这里给大家分享一下，需要的朋友可以参考。
    2017-10-10
  • 解决SpringBoot跨域的三种方式

    解决SpringBoot跨域的三种方式

    前后端分离是目前的趋势，解决跨域问题也是老生常谈的话题了，我们了解一下什么是域和跨域。域：协议 + 域名 + 端口；三者完全相同则为同域，反之有其一不同均为不同域。跨域请求：当前【发起请求】的域和【请求指向】的域属于不同域时，该次请求称之为跨域请求
    2021-06-06
  • linux环境下java程序打包成简单的hello world输出jar包示例

    linux环境下java程序打包成简单的hello world输出jar包示例

    这篇文章主要介绍了linux环境下java程序打包成简单的hello world输出jar包,结合简单hello world输出程序示例分析了Linux环境下的java可执行jar包文件的生成相关操作技巧,需要的朋友可以参考下
    2019-11-11
  • Spring Boot中如何使用断路器详解

    Spring Boot中如何使用断路器详解

    这篇文章主要给大家介绍了关于Spring Boot中如何使用断路器的相关资料，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
    2018-08-08
  • java中Supplier、Function、BiFunction的区别及说明

    java中Supplier、Function、BiFunction的区别及说明

    Supplier、Function、BiFunction是Java函数式编程中常用的三个接口,它们分别用于无参数返回值、单参数返回值和双参数返回值的抽象函数定义
    2026-04-04
  • 详细了解MVC+proxy

    详细了解MVC+proxy

    Java有两种代理方式，一种是静态代理，另一种是动态代理。对于静态代理，其实就是通过依赖注入，对对象进行封装，不让外部知道实现的细节。很多 API 就是通过这种形式来封装的
    2021-07-07
  • Java实现微信登录并获取用户信息功能(开发流程)

    Java实现微信登录并获取用户信息功能(开发流程)

    这篇文章主要介绍了Java实现微信登录并获取用户信息功能(开发流程),本文通过实例代码给大家介绍的非常详细,需要的朋友可以参考下
    2024-07-07
  • JWT + 拦截器实现无状态登录系统

    JWT + 拦截器实现无状态登录系统

    JWT（JSON Web Token）提供了一种无状态的解决方案：用户登录后,服务器返回一个 Token,后续请求携带该 Token 即可完成身份验证,无需服务器存储会话信息,本文将结合 Spring Boot 拦截器,手把手实现一个完整的JWT无状态登录系统,感兴趣的朋友一起看看吧

    2025-08-08
  • JAVA十大排序算法之计数排序详解

    JAVA十大排序算法之计数排序详解

    这篇文章主要介绍了java中的计数排序，本文给大家介绍的非常详细，对大家的学习或工作具有一定的参考借鉴价值，需要的朋友可以参考下
    2021-08-08

最新评论