[Flutter] Your project's Gradle version is incompatible with the Java version that Flutter is using for Gradle.

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':gradle:compileGroovy'.
> BUG! exception in phase 'semantic analysis' in source unit 'C:\flutter\packages\flutter_tools\gradle\src\main\groovy\app_plugin_loader.groovy' Unsupported class file major version 65

* Try:
> Run with --stacktrace option to get the stack trace.
> Run with --info or --debug option to get more log output.
> Run with --scan to get full insights.

* Get more help at https://help.gradle.org

BUILD FAILED in 11s

┌─ Flutter Fix ───────────────────────────────────────────────────────────────────────────────────┐
│ [!] Your project's Gradle version is incompatible with the Java version that Flutter is using   │
│ for Gradle.                                                                                     │
│                                                                                                 │
│ If you recently upgraded Android Studio, consult the migration guide at                         │
│ docs.flutter.dev/go/android-java-gradle-error.                                                  │
│                                                                                                 │
│ Otherwise, to fix this issue, first, check the Java version used by Flutter by running `flutter │
│ doctor --verbose`.                                                                              │
│                                                                                                 │
│ Then, update the Gradle version specified in                                                    │
│ C:\~\android\gradle\wrapper\gradle-wrapper.properties to be compatible                          │
│ with that Java version. See the link below for more information on compatible Java/Gradle       │
│ versions:                                                                                       │
│ https://docs.gradle.org/current/userguide/compatibility.html#java                               │
│                                                                                                 │
│                                                                                                 │
└─────────────────────────────────────────────────────────────────────────────────────────────────┘
Error: Gradle task assembleDebug failed with exit code 1

오류 메시지를 간단히 요약하면 "프로젝트에 설정된 그래들(Gradle) 버전이 현재 사용 중인 자바(Java) 버전과 호환되지 않습니다" 라는 뜻입니다.
최근에 Android Studio를 업데이트하셨거나, Java 버전이 바뀌면서 생긴 문제입니다. 마치 최신 게임을 구형 컴퓨터에서 실행하려는 것과 비슷한 상황입니다.

해결 방법

프로젝트의 그래들(Gradle) 버전을 호환되는 최신 버전으로 올려주세요.

이를 위해 android/gradle/wrapper/gradle-wrapper.properties 파일의 내용을 수정해야 합니다.

참고 명령어 : Read gradle-wrapper.properties

=> 현재 사용하고 있는 그래들 버전을 확인할 수 있어요. 저 같은 경우, gradle-7.6.3-all.zip을 사용하고 있었답니다.
이 버전이 현재 Java 버전과 맞지 않는 것입니다.

호환되는 최신 버전인 gradle-8.4-all.zip 으로 변경하여 문제를 해결하였습니다.

수정 내용

gradle-wrapper.properties 파일의 distributionUrl 부분을 아래와 같이 수정하겠습니다.

zipStoreBase=GRADLE_USER_HOME
zipStorePath=wrapper/dists
distributionUrl=https://services.gradle.org/distributions/gradle-7.6.3-all.zip
distributionUrl=https://services.gradle.org/distributions/gradle-8.4-all.zip

동기화 과정

이제 Android Studio가 새로운 그래들 설정을 인식하고 필요한 파일을 다운로드할 수 있도록 프로젝트를 동기화해야 합니다.
화면 상단에 나타났을 'Sync Now' 링크를 클릭하시거나, 또는 상단 메뉴에서 File > Sync Project with Gradle Files 를 선택해 주세요.

동기화가 완료된 후 (화면 하단에 진행 상태가 표시됩니다) 다시 앱을 실행해 보세요.
이제 호환성 문제가 해결되어 정상적으로 빌드가 진행될 것입니다.

참고로 너무 높은 버전으로 업데이트 해도 문제가 될 수 있습니다. 다음과 같이 말이죠.

startup failed:
C:\flutter\packages\flutter_tools\gradle\src\main\groovy\flutter.groovy: 8: unable to resolve class groovy.xml.QName
 @ line 8, column 1.
   import groovy.xml.QName
   ^

1 error


FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':gradle:compileGroovy'.
> Compilation failed; see the compiler error output for details.

* Try:
> Run with --scan to generate a Build Scan (powered by Develocity).

BUILD FAILED in 1m 11s
Error: Gradle task assembleDebug failed with exit code 1
댓글 쓰기
가져가실 때, 출처 표시 부탁드려요! 감사합니다. 💗