서버가 멈추고 응답하지 않음

증상: 상태가 “Playing”으로 표시되고, 콘솔은 조용하며, 명령이 실행되지 않고, 플레이어가 타임아웃됩니다.

무슨 일이 일어났나요

서버의 메인 스레드가 차단된 상태예요. 플러그인의 무한 루프, 외부 응답 대기, 교착 상태, 치명적인 가비지 컬렉션이 원인이에요.

진단

1. 조용해지기 직전의 마지막 로그 줄 — 보통 원인을 알려줘요. 플러그인 이름, 작업, 좌표 등이에요.
2. Watchdog. Paper는 멈춤을 스스로 감지하고 --- DO NOT REPORT THIS TO PAPER ---로 표시된 스레드 덤프를 원인의 이름과 함께 출력해요 — Watchdog.
3. 리소스 사용량. 콘솔이 조용한데 CPU가 100%라면 루프예요. CPU가 거의 0이라면 외부 리소스(데이터베이스, 네트워크)를 기다리는 중이에요.

해야 할 일

“Stop”을 클릭하세요. 제어판이 stop을 보내고, 서버가 응답하지 않으면 타임아웃 후 프로세스를 강제 종료해요.

강제 종료 중에는 월드의 마지막 몇 분이 유실될 수 있어요. 이는 피할 수 없어요. 멈춘 서버는 더 이상 저장하지 않으니까요.

그다음

• 로그에서 스레드 덤프를 읽어 보세요.
• 의심되는 플러그인을 비활성화하고 테스트하세요 — 플러그인이 서버를 망가뜨리고 있어요.
• 외부 의존성을 확인하세요. 접속할 수 없는 MySQL 데이터베이스는 멈춤의 대표적인 원인이에요.
• 디스크를 확인하세요. 디스크가 가득 차면 쓰기가 차단돼요 — 디스크가 가득 찼어요.

예방

정기적인 자동 재시작과 알림을 설정해서 플레이어보다 먼저 멈춤을 알 수 있게 하세요.