Skip to content
호스팅 · 오류 분석

ConcurrentModificationException

플러그인이 리스트를 순회하는 중에 수정했거나 비동기 스레드에서 게임 스레드에 접근했어요: 왜 위험한지, 어떻게 해야 하는지 알아봐요.

업데이트 2026년 8월 13일

java.util.ConcurrentModificationException
    at java.util.ArrayList$Itr.checkForComodification

컬렉션이 반복 중에 변경되었습니다. Minecraft 맥락에서 이는 거의 항상 플러그인이 다른 스레드의 게임 데이터를 다루고 있다는 뜻입니다.

왜 위험한가

이것은 무해한 오류가 아닙니다. 데이터 손실, 아이템 복제, 월드 손상으로 이어질 수 있습니다. 서버는 계속 실행되지만, 상태는 이미 일관성이 깨진 상태입니다.

무엇을 해야 하나

  1. 스택 트레이스에서 플러그인을 찾으세요 — 아래 줄에 있는 패키지 이름입니다.
  2. 플러그인을 업데이트하세요.
  3. 오류가 계속 발생하면 플러그인을 제거하고 제작자에게 보고하세요. 이는 설정 문제가 아니라 코드의 버그입니다.
  4. /reload를 실행하고 있는지 확인하세요 — 이 명령은 이런 오류를 대량으로 발생시킵니다. 대신 완전 재시작을 사용하세요.

관련 문서

Paper는 비동기 스레드에서 게임 API에 접근할 때 별도의 경고를 출력합니다:

java.lang.IllegalStateException: Asynchronous entity add!

의미는 같습니다 — 플러그인이 해서는 안 되는 일을 하고 있다는 것입니다. 자세한 분석은 플러그인이 서버를 망가뜨립니다를 참고하세요.

Minecraft 호스팅오프라인일 때도 서버가 실행돼요서버 만들기