問題背景：遍歷時修改集合

在項目中，我們經(jīng)常需要對列表進(jìn)行“邊遍歷邊刪除”的操作，比如清理不符合條件的數(shù)據(jù)：

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); // 報錯！
    }
}

運(yùn)行結(jié)果如下：

Exception in thread "main" java.util.ConcurrentModificationException

很多初學(xué)者會以為是多線程并發(fā)的問題，其實不是——這段代碼只有一個線程。真正的原因在于：我們在使用增強(qiáng) for 循環(huán)（底層是 Iterator）遍歷時修改了集合結(jié)構(gòu)。

異常原理：fail-fast 機(jī)制

Java 的集合類（如 ArrayList、HashMap）在遍歷時會維護(hù)一個“結(jié)構(gòu)修改計數(shù)器（modCount）”。每次調(diào)用 add() 或 remove() 時，modCount 都會遞增。

而在使用 Iterator 遍歷時，迭代器內(nèi)部也保存了一個 expectedModCount，表示它期望的修改次數(shù)。每次 next() 時都會檢查：

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

所以，當(dāng)你在遍歷過程中直接操作原集合（而不是通過迭代器），modCount 會變化，而迭代器的 expectedModCount 沒更新，于是觸發(fā)了“fail-fast”保護(hù)機(jī)制。

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

最正統(tǒng)、最安全的方式就是用 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);

輸出結(jié)果：

[Jerry, Spike]

沒有報錯，功能正常。

優(yōu)點：

• 不會觸發(fā) ConcurrentModificationException；
• 無需復(fù)制集合；
• 對性能影響小。

缺點：

• 寫法略繁瑣；
• 只能在單線程環(huán)境中安全使用。

解決方案 2：使用 CopyOnWriteArrayList（線程安全版）

如果你的場景是多線程修改集合，比如在 Web 請求或任務(wù)調(diào)度中共享數(shù)據(jù)，可以使用 CopyOnWriteArrayList。

這個類在寫操作時會復(fù)制底層數(shù)組，從而保證讀操作不會受寫操作影響。

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]

優(yōu)點：

• 支持多線程安全修改；
• 不會觸發(fā)并發(fā)修改異常；
• 讀操作幾乎無鎖，非?？?。

缺點：

• 寫操作開銷較大（每次寫都會復(fù)制整個數(shù)組）；
• 不適合頻繁寫入的場景。

解決方案 3：Stream 流式重建集合（推薦現(xiàn)代寫法）

在 Java 8 之后，其實最推薦的做法是使用 Stream 進(jìn)行過濾或重建集合。這種寫法既優(yōu)雅又安全，不會破壞原集合。

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]

優(yōu)點：

• 不會拋異常；
• 可讀性好；
• 更符合函數(shù)式編程風(fēng)格；
• 支持并行流提升性能。

缺點：

會生成新的集合對象（有一定內(nèi)存開銷）。

實際開發(fā)場景案例

在一個電商系統(tǒng)中，我們有一個用戶購物車 List<CartItem>，每次請求結(jié)算時，需要過濾掉失效的商品。

開發(fā)者最開始寫了這樣一段代碼：

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

上線后偶發(fā)異常。

后來改成：

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

或者更現(xiàn)代一點：

cartItems = cartItems.stream()
        .filter(CartItem::isValid)
        .toList(); // 優(yōu)雅且安全

這樣既避免了異常，也讓邏輯更清晰。

小結(jié)

結(jié)語

ConcurrentModificationException 本質(zhì)上是 Java 集合為我們提供的一種保護(hù)機(jī)制，防止在遍歷過程中意外修改數(shù)據(jù)導(dǎo)致不可預(yù)期結(jié)果。只要理解了它的底層原理——“fail-fast 校驗 modCount”，你就能輕松避開這類問題。

簡單記一句話：

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

到此這篇關(guān)于Java遍歷集合報錯ConcurrentModificationException的原因分析與解決方法的文章就介紹到這了,更多相關(guān)Java ConcurrentModificationException異常內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！