Java: NoClassDefFoundError

[nhkiiim]

개발환경 세팅 중 Gradle refresh 과정에서 NoClassDefFoundError 발생

NoClassDefFoundError

https://docs.oracle.com/javase/8/docs/api/java/lang/NoClassDefFoundError.html

"클래스가 컴파일 될 당시 존재했지만 더 이상 정의를 찾을 수 없습니다."

• Java 가상 머신이나 ClassLoader 인스턴스가 클래스 정의를 로드하려고 시도하지만 클래스 정의를 찾을 수 없는 경우 발생
• 일반적인 메서드 호출의 일부 또는 new를 통해 인스턴스 생성하는 경우 클래스 정의 로드 시도
• 코드가 종속된 클래스 파일이 있고 컴파일 타임에는 존재하지만 런타임에는 찾을 수 없는 경우 발생

[nhkiiim]

📢 build.gradle 설정 오류로 발생한 것으로 확인 -> 의존성 범위 수정으로 해결 완료

[nhkiiim]

build.gradle 설정 오류로 NoClassDefFoundError 발생하는 경우

1. 의존성 누락

• 필요한 라이브러리나 모듈이 dependencies 블록에 추가되지 않았을 경우

  dependencies {
  implementation 'com.example:some-library:1.0.0' // 필요한 라이브러리를 추가
  }

  2. 의존성 범위 설정 오류

• 컴파일 시 필요한 의존성이 런타임 시에는 포함되지 않는 경우

• compileOnly로 설정된 의존성은 런타임 클래스 경로에 포함되지 않음

dependencies {
    compileOnly 'com.example:some-library:1.0.0' // 런타임 시 필요하다면 compileOnly 대신 implementation을 사용
    implementation 'com.example:another-library:1.0.0'
}

3. 멀티 모듈 프로젝트 설정 오류

• 멀티 모듈 프로젝트에서 모듈 간 의존성이 제대로 설정되지 않은 경우

dependencies {
    implementation project(':another-module') // 다른 모듈에 대한 의존성 추가
}

4. 레포지토리 설정 오류

• 필요한 라이브러리가 있는 레포지토리가 설정되지 않았을 경우.

repositories {
    mavenCentral() // 또는 jcenter(), google() 등 필요한 리포지토리를 추가
}

5. 플러그인 설정 오류

• 올바른 플러그인이 적용되지 않은 경우

plugins {
    id 'java' // 필요한 플러그인 적용
}

[nhkiiim]

ClassNotFoundException 과의 차이

ClassNotFoundException

• 클래스가 클래스 경로에서 발견되지 않았음을 나타냄
• 클래스 정의를 로드하려고 했지만 클래스가 클래스 경로에 존재하지 않음!

NoClassDefFoundError

• JVM이 내부 클래스 정의 데이터 구조에서 클래스 정의를 찾았지만 로드하지 못했음을 나타냄

[nhkiiim]

🎃 기타 다양한 발생 원인 참고 https://stackoverflow.com/questions/34413/why-am-i-getting-a-noclassdeffounderror-in-java