如何在 Java 中使用 Iterator.remove() 在安全遍历集合的同时删除满足业务条件的特定元素

Iterator.remove()：遍历集合时安全删除元素的唯一正确姿势

在Ja va开发中，有一个经典的“坑”几乎每个程序员都踩过：在遍历集合时试图删除元素，结果迎面撞上恼人的 ConcurrentModificationException。无论是直接调用集合自身的 remove() 方法，还是在简洁的增强for循环里动手，都会立刻触发这个异常。那么，安全删除的正确方式到底是什么？答案很明确：使用 Iterator.remove()。这是语言设计者提供的、在单线程遍历过程中进行结构性修改的唯一安全通道。

为什么只能是 Iterator.remove()？

要理解这个“唯一性”，得先看看Ja va集合框架的内部机制。像 ArrayList、HashSet 这样的集合，内部都维护着一个叫 modCount 的“修改计数器”。每次对集合结构做出改动（增、删），这个数字就会加一。而当你创建一个迭代器时，它会悄悄记下此刻的 modCount 值，存为 expectedModCount。

关键点来了：每次调用 iterator.next() 获取下一个元素前，迭代器都会做一次“安全检查”，比对当前的 modCount 和自己记录的 expectedModCount 是否一致。如果发现不一致——比如你在循环里直接调用了 list.remove(item)，导致集合的 modCount 变了而迭代器不知情——它就会毫不犹豫地抛出 ConcurrentModificationException，以此阻止可能引发数据错乱的后续操作。

而 Iterator.remove() 之所以能成为特例，是因为它“内外兼修”：这个方法由迭代器对象自己来执行删除操作，并且在删除完成后，会同步更新自己内部的 expectedModCount，使其与集合最新的 modCount 保持一致。这样一来，一致性校验就能顺利通过，遍历得以安全继续。

掌握 Iterator.remove() 的正确步骤

使用这个方法，有两个铁律必须遵守：必须先 next() 再 remove()，并且每次循环中 remove() 最多调用一次。违反任何一条，都会导致 IllegalStateException。

具体的操作流程可以归纳为以下几步：

• 获取迭代器：首先，通过集合的 iterator() 方法拿到专属的迭代器对象。
• 循环遍历：使用 while (it.hasNext()) 作为循环条件，确保在安全范围内操作。
• 定位与判断：在循环体内，务必先通过 it.next() 获取当前元素，然后再根据业务逻辑判断这个元素是否需要删除。
• 执行删除：如果满足删除条件，调用 it.remove()。这一步会删除上一次 next() 方法返回的元素。

需要警惕的是，在调用一次 remove() 之后，必须再次调用 next() 移动到新元素，才能进行下一次删除。连续调用两次 remove()，或者在调用 next() 之前就调用 remove()，都会触发异常。

从错误到正确：一个代码对比示例

假设我们需要删除一个字符串列表中所有长度大于5的元素。下面是一个典型的错误示范，使用了增强for循环：

for (String s : list) {
    if (s.length() > 5) {
        list.remove(s); // ❌ 立即抛出 ConcurrentModificationException
    }
}

这段代码看起来简洁，但一运行就会崩溃。因为增强for循环在底层同样使用了迭代器，直接调用 list.remove(s) 破坏了迭代器与集合之间的状态约定。

正确的做法是使用迭代器显式操作：

Iterator it = list.iterator();
while (it.hasNext()) {
    String s = it.next(); // 先定位元素
    if (s.length() > 5) {
        it.remove(); // ✅ 通过迭代器安全删除
    }
}

这才是万无一失的写法。迭代器清楚地知道当前操作的元素是谁，并且能妥善处理好内部的状态同步。

现代替代方案与重要注意事项

当然，如果你使用的是Ja va 8或更高版本，有更优雅的写法。集合框架提供了 removeIf(Predicate filter) 方法，它用一行代码就能完成过滤删除：

list.removeIf(s -> s.length() > 5); // ✅ 清晰且安全

这个方法在内部本质上仍然是基于迭代器模式实现的，只是语法糖让我们写起来更舒服。对于简单的条件删除，这无疑是首选。

不过，有几点需要额外注意：

• 避免混用：不要在代码中既使用 removeIf()，又在另一个循环里手动使用 iterator.remove()，这会让逻辑变得难以理解和维护。
• 线程安全并非万能：Iterator.remove() 解决的是单线程遍历时的修改异常问题，它并不提供任何线程安全的保证。如果集合会被多个线程同时访问和修改，你必须寻求更根本的解决方案，例如使用 CopyOnWriteArrayList 这样的线程安全集合，或者在操作时进行恰当的同步加锁。

说到底，理解 Iterator.remove() 的原理，不仅是学会一个API的用法，更是理解Ja va集合框架“快速失败”（fail-fast）设计思想的一把钥匙。在恰当的场合使用它，能让你的代码既安全又清晰。