Java ClassNotFoundException 오류 해결 방법
Java에서 ClassNotFoundException은 JVM이 실행 중에 특정 클래스를 찾지 못할 때 발생합니다. 주로 클래스패스 설정 문제나 JAR 파일 누락이 원인입니다.
오류 예시
Exception in thread "main" java.lang.ClassNotFoundException: com.example.MyClass
원인
- 클래스패스에 해당 클래스가 포함되지 않음
- JAR 파일 누락
- 빌드 도구(Gradle/Maven) 설정 오류
- 패키지 경로와 클래스 선언 불일치
해결 방법
- 실행 시
-cp옵션으로 클래스패스 지정 - JAR 파일이 포함되어 있는지 확인
- Gradle/Maven 빌드 설정 점검 후 재빌드
- 패키지 구조와 클래스 선언이 일치하는지 확인
💡 팁:
jar tf 파일명.jar 명령으로 JAR 내부에 클래스가 존재하는지 빠르게 확인할 수 있습니다.