Java ConcurrentModificationException: что означает исключение

Что означает ошибка

Коллекция обнаружила недопустимое структурное изменение во время обхода.

Возможные причины

• Коллекция меняется напрямую внутри for-each.
• Другой поток изменяет non-concurrent collection.
• Iterator используется после внешнего структурного изменения.

Что проверить

• Найдите место создания iterator и все записи в коллекцию до падения.
• Проверьте, выполняется ли модификация из другого потока.
• Сведите код к одному проходу и одной операции изменения.

Безопасные шаги

1. Используйте `Iterator.remove()` там, где это предусмотрено.
2. Для конкурентного сценария выберите подходящую concurrent collection/синхронизацию.
3. Не рассчитывайте, что исключение гарантированно обнаружит каждую гонку.

Только безопасные обратимые действия. Опасные шаги — только по официальной инструкции и с пониманием рисков.

Когда нужен сервис

• Если ConcurrentModificationException появляется при многопоточном доступе или сложном обходе, приложите место итерации и точки изменения коллекции разработчику для пересмотра синхронизации.

Похожие ошибки

• /errors/java-illegalargumentexception/
• /errors/java-illegalstateexception/
• /errors/java-indexoutofboundsexception/

Что учитывать

Точная причина зависит от версии ПО/прошивки, полного текста ошибки и контекста. Официальная инструкция имеет приоритет.

Официальный источник

Расшифровка сверена с официальными страницами поддержки из источников ниже. Редакция N1RO не диагностировала ваш конкретный случай.

• Oracle Java SE 21 API — ConcurrentModificationException