Java List 添加删除为什么报错?原因解析

最常见原因是遍历List时直接调用remove()或add()触发ConcurrentModificationException;这是fail-fast机制所致,因modCount与expectedModCount不一致而抛出异常。

Java 中对 List 进行添加或删除操作时报错,最常见原因是在遍历 List 的同时直接调用 remove() 或 add() 方法,触发了 ConcurrentModificationException(并发修改异常)。这不是线程安全问题,而是 Java 集合的“快速失败”(fail-fast)机制在起作用。

遍历时不能直接增删元素

ArrayList、LinkedList 等非线程安全集合内部维护了一个 modCount(修改计数器),每次调用 add/remove 时都会递增。而迭代器(如 for-each、iterator.next())在创建时会记录当时的 modCount 值(expectedModCount)。只要两者不一致,下一次调用 next() 或 hasNext() 就会抛出 ConcurrentModificationException。

  • ❌ 错误写法(for-each 循环中 remove):
    for (String s : list) { if (s.equals("abc")) list.remove(s); }
  • ❌ 错误写法(普通 for 循环,从前往后删):
    for (int i = 0; i (会导致漏删相邻元素)

安全删除的正确方式

要边遍历边删,必须使用迭代器自身的 remove() 方法,它会同步更新 expectedModCount。

  • ✅ 推荐:用 Iterator 显式删除
    Iterator it = list.iterator();
    while (it.hasNext()) {
      if (it.next().equals("abc")) it.remove();
    }
  • ✅ Java 8+ 可用 removeIf()
    list.removeIf(s -> s.equals("abc"));(内部也是用迭代器实现)
  • ✅ 删除多个元素可先收集索引,倒序删除
    List toRemove = new ArrayList();
    for (int i = 0; i   if (list.get(i).equals("abc")) toRemove.add(i);
    }
    Collections.reverse(toRemove);
    for (int i : toRemove) list.remove(i);

不可变 List 导致 add/remove 报 UnsupportedOperationException

Arrays.asList()List.of() 创建的 List 是固定大小、不可修改的视图或不可变实例。

  • ❌ Arrays.asList 返回的是 Arrays 内部类,支持 set(),但不支持 add/remove:
    List list = Arrays.asList("a", "b");
    list.add("c"); // 报 UnsupportedOperationException
  • ✅ 解决:包装成可变 ArrayList
    List mutable = new ArrayList(Arrays.asList("a", "b"));
  • ✅ List.of()(Java 9+)是真正不可变的,任何修改操

    作都报错,必须重新构造:
    List newList = new ArrayList(List.of("a", "b"));

多线程环境下未同步导致的异常

如果多个线程同时读写同一个 ArrayList/LinkedList,即使没遍历,也可能因结构被并发修改而抛出 ConcurrentModificationException 或产生数据错乱。

  • ✅ 单线程场景:用 ArrayList/LinkedList + 迭代器安全删除即可
  • ✅ 多线程场景:
      – 用 Collections.synchronizedList()(注意:迭代仍需手动同步)
      – 或用 CopyOnWriteArrayList(适合读多写少,迭代时不加锁)

基本上就这些。核心就两点:遍历时别用 list.remove(),要用 iterator.remove();别把 Arrays.asList 或 List.of 当成可变容器用。不复杂但容易忽略。