빠른 해결 요약
Eclipse가 갑자기 멈춰서 응답하지 않나요? 대부분 프로세스 충돌이나 메모리 부족, 워크스페이스 손상이 원인입니다. 아래 6가지 방법을 순서대로 시도해보세요.
- 프로세스 강제 종료 — 작업 관리자에서 eclipse.exe와 javaw.exe 완전 종료
- 클린 시작 실행 —
-clean -clearPersistedState
옵션으로 캐시 초기화 - 새 워크스페이스 테스트 — 문제 원인을 워크스페이스와 Eclipse 설치로 분리
- eclipse.ini 점검 — JDK 경로 설정과 메모리 할당량 조정
- 캐시 파일 정리 — .metadata 폴더 내 손상된 파일 제거
- 인덱싱 최적화 — 대용량 폴더 필터링으로 성능 개선
목차
문제 증상 확인하기
다음과 같은 증상이 나타나면 Eclipse 응답 없음 문제입니다:
- 창 제목 표시줄에 "응답 없음" 또는 "Not Responding"이 표시
- 화면이 흰색이나 회색으로 변하며 클릭해도 반응 없음
- 상태바에 "Building workspace...", "Refreshing workspace..." 작업이 무한 진행
- Eclipse 시작 화면(스플래시) 이후 바로 멈춤
방법 1: 프로세스 강제 종료
가장 먼저 시도할 기본적인 해결 방법입니다. Eclipse가 백그라운드에서 계속 실행되고 있을 수 있습니다.
- Ctrl + Shift + Esc를 눌러 작업 관리자 실행
- 프로세스 탭에서 다음 항목들을 찾아 작업 끝내기 클릭:
eclipse.exe
javaw.exe
java.exe
(있는 경우, 단 Eclipse 관련일 때만 종료)
- 다른 프로그램에서 사용하는 Java 프로세스는 종료하지 말고, 반드시 설명 열에서 Eclipse 관련 여부 확인 후 종료
- 모든 관련 프로세스를 종료한 후 Eclipse 재시작
방법 2: 클린 시작으로 캐시 초기화
Eclipse의 플러그인 캐시나 UI 상태 정보가 손상되었을 때 효과적입니다. (Windows의 "Clean Boot"와는 다릅니다)
명령어 실행 방법:
eclipse.exe -clean -clearPersistedState
각 옵션의 역할:
-clean
: 번들(플러그인) 캐시를 재구성-clearPersistedState
: UI 레이아웃과 상태 저장소를 초기화
방법 3: 새 워크스페이스로 테스트
eclipse.exe -data "C:\temp-workspace"
결과 분석:
방법 4: eclipse.ini 설정 최적화
eclipse.ini 파일의 JVM 설정과 메모리 할당이 잘못되어 있을 때 자주 발생합니다.
JDK 경로 설정 (-vm 옵션)
- 64-bit Eclipse는 반드시 64-bit JDK 사용 (32-bit 조합은 1200~1500MB 메모리 한계)
-vm
옵션은-vmargs
위에 위치해야 함-vm
다음 줄에 javaw.exe의 전체 경로 입력
올바른 eclipse.ini 예시:
-vm C:\Program Files\Java\jdk-17\bin\javaw.exe -vmargs -Xms512m -Xmx4096m -XX:+UseG1GC
메모리 설정 최적화
-Xms512m
: 시작 메모리 (512MB)-Xmx4096m
: 최대 메모리 (4GB, 시스템 RAM에 맞게 조정)-XX:+UseG1GC
: 가비지 컬렉터 최적화
방법 5: 워크스페이스 캐시 정리
워크스페이스의 .metadata 폴더에 손상된 파일들이 Eclipse를 멈추게 할 수 있습니다.
주의: Eclipse를 완전히 종료한 상태에서 진행하세요.
선별적 파일 삭제 (권장)
다음 파일들을 삭제해보세요:
<워크스페이스>\.metadata\.plugins\org.eclipse.core.resources\.snap
<워크스페이스>\.metadata\.lock
최후 수단: .metadata 전체 재생성
- .metadata 폴더를 다른 곳에 백업
- .metadata 폴더 삭제
- Eclipse 재시작 (새로운 .metadata 자동 생성)
- 프로젝트들을 다시 Import
방법 6: 대용량 폴더 필터링
불필요한 폴더를 Eclipse가 스캔하지 않도록 설정하여 성능을 개선합니다.
설정 경로:
- 프로젝트 우클릭 → Properties
- Resource → Resource Filters 선택
- Add Filter 클릭
- 다음 폴더들을 Exclude 처리:
node_modules | .git | build | dist | target (Maven) |
스크린샷 가이드
- 화면: 작업 관리자의 프로세스 탭
- 포함 요소: eclipse.exe, javaw.exe 프로세스와 "작업 끝내기" 버튼
- 권장 해상도: 1200px 이상 너비, PNG 형식
- 파일명:
eclipse-not-responding-task-manager.png
영문 검색 키워드 (추가 자료 탐색용):
Eclipse not responding Windows
eclipse.ini -vm configuration example
Eclipse workspace .metadata corruption
Eclipse increase heap size memory
자주 묻는 질문
Q. 32비트와 64비트를 왜 맞춰야 하나요?
Eclipse와 JDK의 비트 수가 다르면 시작 자체가 불가능하거나 불안정해집니다. 64비트 Eclipse는 반드시 64비트 JDK가 필요하며, 혼용 시 "응답 없음" 문제가 자주 발생합니다.
Q. 메모리는 얼마나 할당하는 게 좋나요?
일반적으로 -Xmx2048m
(2GB)~-Xmx4096m
(4GB) 정도가 적당합니다. 시스템 RAM의 절반 이상은 할당하지 않는 것이 좋으며, 대형 프로젝트의 경우 더 늘릴 수 있습니다.
Q. 모든 방법을 시도해도 해결되지 않으면?
Eclipse 최신 버전과 JDK 업데이트 후에도 문제가 지속된다면 Eclipse 재설치를 고려하거나 IntelliJ IDEA, VS Code 등 다른 IDE를 검토해보세요.
마무리 및 참고 자료
Eclipse 응답 없음 문제는 대부분 위 6가지 방법으로 해결됩니다. 프로세스 강제 종료부터 시작해서 eclipse.ini 최적화까지 순차적으로 시도해보세요.
문제가 지속되면:
- Java 버전 업데이트 고려
- Eclipse 최신 버전으로 업그레이드
- 시스템 리소스 모니터링 (RAM, CPU 사용량)
0 댓글