IntelliJ Gradle 실행 오류 해결하기

Execution failed for task ‘:server:.main()’ / Process finished with non-zero exit value 1

 

오류 상황

Spring Boot나 Gradle 프로젝트를 IntelliJ에서 실행할 때

아래와 같은 메시지가 출력되며 프로그램이 종료되는 경우가 있습니다.

Execution failed for task ':server:.main()'. > Process 'command '/Users/Library/Java/JavaVirtualMachines/temurin-17.0.15/Contents/Home/bin/java'' finished with non-zero exit value 1

 

처음 보면 복잡해 보이지만,

대부분 IntelliJ 실행 설정(Build & Run 설정) 문제로 쉽게 해결할 수 있습니다.

원인

이 오류는 IntelliJ가 Gradle을 통해 애플리케이션을 빌드하고 실행하는 과정에서

내부 JVM 설정이 꼬이거나 Gradle 런타임 환경이 불일치할 때 발생합니다.

 

즉, Gradle 대신 IntelliJ 자체 실행 방식을 사용하면 문제가 사라지는 경우가 많습니다.

 

해결 방법

1. IntelliJ 설정 열기

 

상단 메뉴에서 아래 순서로 이동합니다.

File → Settings (macOS는 Preferences)

 

캡처 포인트 ①

• Settings 창이 열리고 왼쪽에 메뉴 트리가 보이는 화면
• Build, Execution, Deployment 메뉴가 펼쳐진 모습

2. Gradle 설정 이동

 

왼쪽 메뉴에서 다음 경로로 이동합니다.

Build, Execution, Deployment → Build Tools → Gradle

• Gradle 설정 화면에서
• Build and run using: 및 Run tests using: 옵션이 보이는 부분

3. 실행 옵션 변경

두 항목 모두 아래와 같이 변경합니다.

설정이 IntelliJ IDEA로 변경된 후의 화면

4. 적용 후 재실행

Apply → OK 클릭 후

프로젝트를 다시 실행(Run)합니다.

 

이제 non-zero exit value 1 오류가 더 이상 발생하지 않아야 합니다.

 

추가 점검 사항

 

문제가 지속될 경우 다음 항목을 확인해 보세요.

• Gradle JVM 설정 확인예: temurin-17, corretto-17, openjdk-17 등
• Gradle JVM이 실제 사용하는 JDK 버전과 일치해야 합니다.
• Gradle 캐시 정리

./gradlew clean

 

• 터미널에서 직접 실행

./gradlew bootRun --stacktrace