기록

[GPT가 알려주는 Springboot] gradlew.bat 실행해서 실행파일 만드는 법 본문

잡동사니/GPT가 알려주는

[GPT가 알려주는 Springboot] gradlew.bat 실행해서 실행파일 만드는 법

heylo 2025. 9. 12. 11:57

Windows CMD(명령 프롬프트)에서 gradlew.bat을 실행하는 방법을 정리해 드릴게요 ✅


1. 프로젝트 경로로 이동

먼저 gradlew.bat 파일이 있는 프로젝트 루트 폴더로 이동해야 합니다.

cd 경로\프로젝트폴더

예시:

cd C:\Users\User\OneDrive\바탕 화면\iamge_size_compare\short_practice\hello-spring

2. gradlew.bat 실행

CMD에서는 단순히 다음처럼 실행하면 됩니다.

gradlew.bat build

혹은 더 짧게:

gradlew build

👉 build 대신 원하는 Gradle 태스크를 넣으면 됩니다. (예: clean, bootRun, test 등)


3. 주의할 점

  • Java 설치 확인: java -version으로 설치 및 환경변수(JAVA_HOME)가 잡혀 있어야 합니다.
  • Gradle Wrapper: gradlew.bat는 프로젝트에 포함된 Gradle Wrapper이므로, 별도 Gradle 설치 없이 실행됩니다.
  • PowerShell 사용 시: PowerShell에서는 .\gradlew.bat build 처럼 앞에 .\ 붙여야 합니다.

예시 실행

C:\Users\User\OneDrive\바탕 화면\iamge_size_compare\short_practice\hello-spring> gradlew.bat build

👉 혹시 원하시면 제가 gradlew.bat로 Spring Boot 애플리케이션 실행하는 명령어도 같이 정리해드릴까요?

 

 

이 에러는 Windows에서 build/ 폴더(특히 build/libs/*.jar)를 어떤 프로세스가 잡고 있어서 지우지 못할 때 나옵니다. (IDE가 실행 중이거나, 이전에 실행한 앱이 아직 떠 있거나, OneDrive 동기화/바이러스 스캔이 점유하는 경우가 흔함)

빠른 해결 순서

  1. 앱/IDE/탐색기 점유 해제
  • IntelliJ/VS Code의 실행(▶) 중지, 터미널에서 돌던 bootRun 종료
  • 파일 탐색기에서 build/libs 폴더 열어둔 창 닫기(미리보기/인덱싱도 잠금 원인)
  • OneDrive가 동기화 중이면 잠깐 일시 중지(트레이 아이콘 → 일시중지)
  1. Gradle/Java 프로세스 종료
gradlew --stop
tasklist | findstr /I java
taskkill /F /IM java.exe
  1. 다시 클린 실행
gradlew clean

그래도 안 되면

  • 수동 삭제
    앱/IDE/탐색기를 모두 닫은 뒤:그 다음 gradlew build 재실행.
  • rmdir /S /Q build
  • 데몬/스캔 영향 줄이기
  • gradlew clean -Dorg.gradle.daemon=false
  • 프로젝트를 OneDrive 밖으로 이동
    경로가 OneDrive\바탕 화면\... 아래라 잠금이 자주 걸립니다.
    예: C:\dev\hello-spring 같은 로컬 폴더로 이동 권장.
  • 권한 문제
    관리자 권한 CMD로 시도.

원인 체크 포인트

  • 최근에 java -jar build/libs/xxx.jar 실행한 뒤 창만 닫았는지? → 백그라운드에 남아 있을 수 있어요.
  • IntelliJ의 Build Output 탭/탐색기가 build/libs를 보고 있는지?
  • 실시간 백신/인덱싱(Defender, OneDrive)이 *.jar를 스캔 중인지?

위 순서대로 하면 대부분 바로 해결됩니다. 필요하면 현재 실행 중인 프로세스 스크린샷(또는 tasklist 출력) 주시면, 어떤 프로세스가 파일을 잡고 있는지 콕 집어 드릴게요.