[Spring] Trouble Gradle

상황

Spring 학습을 위해 GitHub에서 spring-advanced프로젝트를 포크받아 로컬에서 실행하려 했다.
이전에 진행한 팀프로젝트에서는 ./gradlew명령어로 정상 빌드가 가능했기 때문에 동일하게 동작할 것으로 기대했다.

 

문제 발생

 

.\gradlew build

프로젝트 루트 경로에서 다음 명령 실행 시 에러 발생

Exception in thread "main" java.lang.RuntimeException: 
Wrapper properties file 'C:\Users\user\Desktop\spring-advanced\gradle\wrapper\gradle-wrapper.properties' does not exist.

또한 gradle -v 명령어도 처음에는 동작하지 않았다.

 

 

원인 파악 및 분석

• Gradle 설치 부재

 

로컬PC에 Gradle이 설치되어 있지 않아 gradle 명령어 자체가 실행되지 않았다.
팀프는 Gradle Wrapper가 모두 포함되어 있어서 시스템에 별도 설치가 없어도 실행 가능했다.

 

• Wrapper파일 불완전

spring-advanced프로젝트는 gradlew, gradlew.bat, gradle/wrapper폴더는 존재했으나 핵심 파일인 gradle-wapper.properties가 누락되어 있었다.
settings.gradle은 단순히 프로젝트명을 지정하는 역할(rootProject.name='export')만 하고  Wrapper 동작과는 무관

 

 

따라서 Gradle이 어떤 버전을 다운로드해야 할지 알 수 없어 실행 시도 시 Could not load wapper properties에러가 발생한 것

결론, Gradle 실행 불가의 근본 원인인 gradle-wapper.properties 파일의 누락

 

 

해결

1. 전역 Gradle 설치

https://gradle.org/releases/

Gradle | Releases

 

공식 사이트에서 gradle-9.0.0-bin.zip 다운로드 후 
C:\Users\user\Desktop\gradle-9.0.0-bin\gradle-9.0.0경로에 압축 해제

 

환경 변수

• GRADLE_HOME = C:\Users\user\Desktop\gradle-9.0.0-bin\gradle-9.0.0
• Path에 %GRADLE_HOME%\bin 추가

 

cmd에 gradle -v 명령어 입력하여 정상동작 확인!

gradle -v

 

2. Wrapper 재생성

이후에 프로젝트 루트에 아래 명령어 실행!

gradle wrapper --gradle-version 8.10.2

이 과정에서 gradlew, gradlew.bat, gradle/wapper/gradle-wrapper.properties가 다시 생성됨

gradlew
gradlew.bat
gradle/wrapper/gradle-wrapper.properties
gradle/wrapper/gradle-wrapper.jar

빌드/실행 확인

.\gradlew --version
.\gradlew clean build

 

 

 

 

---

 

 

 

그럼 대체 왜 팀프 때는 잘 되던 게 포크 받아온 프로젝트에서는 안되었을까?

 

차이점

 

팀프(정상 동작)

레포에는 Gradle Wrapper 풀세트가 이미 포함되어 있었다

따라서 로컬 PC에 전역 Gradle 설치가 없어도 ./gradlew 실행 시 자동으로 지정된 버전의 Gradle을 다운로드 받아 사용 가능함

즉, 로컬 환경에 Gradle이 있든 없든 문제 없이 동작함

 

spring-advanced (문제발생)

레포 Wrapper 스크립트와 폴더는 있지만, 핵심 파일인 gradle-wapper.properties가 누락되어 있다.

Wapper가 사용할 Gradle 버전을 알 수 없어 실행 실패

Wrapper properties file '...gradle-wrapper.properties' does not exist.

 

따라서 전역 Gradle 설치가 없던 시점에는 gradle도 gradlew도 둘 다 동작 불가

 

 

 

 

하지만, InteliJ에는 코끼리 아이콘이 있는데??(Gradle플러그인)

인텔리제이는 Gradle플러그인을 기본 제공해서 코끼리 아이콘이 뜨지만, 실제 빌드는 프로젝트 내 gradle-wapper.properties 또는 시스템 Gradle을 참고함

spring-advanced는 Wapper 불완전-> Gradle 실행 불가 상태였다.

아이콘이 있다고 해서 Gradle이 정상적으로 실행 가능한 건 아님

 

 

따라서, 팀프는 wrapper가 완전했기 때문.