[Error] Gradle / Could not find or load main class org.gradle.wrapper.GradleWrapperMain

💥 에러

./gradlew clean bootjar
Error: Could not find or load main class org.gradle.wrapper.GradleWrapperMain
Caused by: java.lang.ClassNotFoundException: org.gradle.wrapper.GradleWrapperMain

 

프로젝트를 Jenkins 서버에 배포를 시도할 때, 다음과 같은 에러를 마주했습니다.

위 에러는 Gradle Wrapper가 실행될 때 GradleWrapperMain 클래스를 찾을 수 없어서 발생하는 문제입니다.

 

원인은 여러가지가 있을 수 있지만, 찾아본 바로는 Gradle Wrapper가 실행될 때,

gradle-wrapper.jar 파일을 실행하여 gradle 설치 없이 프로젝트를 실행하는데, 이 파일이 없거나 손상되면 에러가 발생합니다.

 

실제로 프로젝트에서 /gradle/wrapper/gradle-wrapper.jar 파일을 찾을 수 없었습니다.

 

 

💭 해결

1) gradle-wrapper.jar 누락

다른 프로젝트에서는 gradle-wrapper.jar 파일이 있었지만, 현재 프로젝트에서 누락된 이유가 무엇일까요??

이는 .gitignore에서 기본적으로 *.jar 파일을 제외하였기 때문입니다.

# .gitignore

# Package files
*.jar

# Add
!gradle/wrapper/gradle-wrapper.jar

 

 

2) gradle-wrapper.jar 생성

1. 프로젝트 내 터미널 실행

./gradlew clean bootjar

 

2. gradle wrapper 실행

- 일반적으로 여기에서 'gradle-wrapper.jar' 파일이 생성됩니다.

gradle wrapper

 

3. gradle version 확인

- gradle wrapper에서 에러가 났을 경우, 프로젝트에서 설정한 gradle version과 로컬에서 기본적으로 설정된 gradle version이 동일한지 확인합니다.

gradle -v

 

4. gradle 설치

- gradle version이 다를 경우, 버전에 맞는 gradle을 설치합니다.

sdk install gradle {}

 

5. gradle version 변경

sdk use gradle <version>       # 현재 터미널 세션에서만 활성화
sdk default gradle <version>   # 기본값으로 활성화

 

cf. 실행권한 부여

- Jenkins나 EC2 인스턴스에 배포 시, 파일에 실행 권한이 없으면 Permission denied 에러가 발생하므로, 반드시 실행 권한을 부여해주도록 합니다.

chmod +x ./gradlew