마인크래프트/서버 오류

마인크래프트 서버 오류는 마인크래프트 서버를 구동하거나 접속할 때 콘솔과 클라이언트에 나타나는 오류 메시지를 정리한 문서이다. 각 오류의 원인과 해결 방법은 아래 표에서 개별 문서로 연결된다.

오류 메시지를 읽을 때는 다음을 먼저 확인하는 것이 좋다.

• 마지막 줄이 아니라 첫 줄을 본다. 스택 트레이스의 아래쪽은 오류가 전달된 경로이고, 실제 원인은 위쪽에 있는 경우가 많다.
• Caused by: 항목을 찾는다. 근본 원인이 이 줄 뒤에 적힌다.
• 플러그인 이름이 함께 나오면 그 플러그인의 문제일 가능성이 높다. 다만 ProtocolLib처럼 다른 플러그인이 공통으로 사용하는 라이브러리는 이름만 보고 판단할 수 없다.
• 버전을 올린 직후라면 대부분 호환 문제다. 마인크래프트 버전 체계와 각 플러그인의 지원 범위를 확인한다.

구동 단계 오류

메시지	요약
UnsupportedClassVersionError	Java 버전이 낮아 클래스를 읽지 못한다
OutOfMemoryError: Java heap space	할당된 힙 메모리를 모두 사용했다
Failed to bind to port	사용하려는 포트가 이미 점유되어 있다
Missing dependency	선행 플러그인이 설치되지 않았다
Mixin apply failed	모드가 게임 코드를 변형하는 데 실패했다

성능·틱 오류

메시지	요약
Can't keep up	한 틱 처리가 기준 시간을 넘겼다
Watchdog thread	서버가 응답하지 않아 감시 스레드가 종료시켰다
Ticking entity	특정 엔티티나 블록 엔티티 처리 중 예외가 발생했다

접속 오류

메시지	요약
Outdated server · Outdated client	클라이언트와 서버의 프로토콜 버전이 다르다
ReadTimeoutException	일정 시간 동안 패킷이 오가지 않아 연결이 끊겼다
Connection reset by peer	상대편이 연결을 예고 없이 끊었다
Failed to verify username	모장 세션 서버 인증에 실패했다

월드·저장 오류

메시지	요약
Chunk saving failed	청크를 지역 파일에 기록하지 못했다

같이 보기

• 마인크래프트/서버 운영
• 마인크래프트/서버 최적화
• 마인크래프트/플러그인
• 마인크래프트 버전 체계