Gradle 프로젝트의 *.kts 파일 문법을 읽지 못하고 "Cannot access script base class 'org.gradle.kotlin.dsl.KotlinBuildScript' ... " 에러가 발생

참고 문서

• youTrack.jetbrain.com: Issue-KTIJ-893 Gradle Kotlin DSL cannot be parsed ...
• IntelliJ IDEA Support: Directories used by IDE to store settings, caches, plugins and logs

이 문서의 내용

테스트 환경 및 주요 아젠다

Gradle init으로 생성한 Gradle 프로젝트를 IntelliJ IDEA에서 로드하였습니다.

Gradle 프로젝트의 빌드 스크립트 settings.gradle.kts와 build.gradle.kts 파일의 Kotlin 문법을 읽지 못하고 다음 에러가 발생합니다.

Cannot access script base class 'org.gradle.kotlin.dsl.KotlinBuildScript'. Check your module classpath for missing or conflicting dependencies

IntelliJ IDEA | Problems에는 상기 에러 메시지와 함께 *.kts 파일 전체가 오류로 표시됩니다.

프로젝트를 컴파일하고 실행(Run)은 문제 없이 동작합니다.

이 프로젝트의 개발 환경

• OS 및 IDE 버전
  • macOS Sonoma 14.1
  • IntelliJ IDEA 2020.3 Ultimate Edition
• Gradle/Kotlin 버전
  • Gradle 8.4
  • Kotlin Plugin 203-1.4.10-release-IJ7717.8

Step 1: IntelliJ IDEA에서 프로젝트 캐시 삭제 및 재시작

IntelliJ IDEA에서 상단 툴바의 File | Invalidate Caches / Restart를 클릭합니다.

팝업이 뜨면 Invalidate and Restart를 누릅니다.

문제가 발생한 프로젝트 외에 다른 프로젝트가 열려있다면 열려있는 모든 프로젝트가 재시작되므로 주의합니다.

Step 2: Gradle 및 IntelliJ IDEA 캐시 디렉토리 삭제 및 재시작

Step 1의 방법으로 해결되지 않으면 Gradle 및 IntelliJ IDEA 캐시 디렉토리를 완전히 삭제하고 재시작합니다.

관련 경로는 macOS Sonoma 14.1 기준으로 작성되었습니다.

OS 환경 별 IntelliJ IDEA 캐시 디렉토리 경로는 IntelliJ IDEA Support: Directories used by IDE to store settings, caches, plugins and logs를 참고합니다.

Gradle 캐시 디렉토리를 삭제합니다. 디렉토리 경로는 ~/.gradle/caches입니다.

$ rm -fr ~/.gradle/caches

IntelliJ IDEA 캐시 디렉토리를 삭제합니다. 디렉토리 경로는 ~/Library/Caches/JetBrains/<IntelliJ IDEA 버전>입니다.

$ rm -fr ~/Library/Caches/JetBrains/IntelliJIdea2020.3

Gradle 프로젝트 루트 디렉토리에서 .gradle과 .idea 파일을 삭제합니다.

$ cd <프로젝트 루트 디렉토리 경로>

$ sudo ls
.gitattributes          .gradle                 app                     gradlew                 settings.gradle.kts
.gitignore              .idea                   gradle                  gradlew.bat

$ rm -fr .gradle
$ rm -fr .idea

열려있는 모든 IntelliJ IDEA 프로젝트를 종료합니다. 문제가 발생한 프로젝트를 다시 import합니다.

Step 3: Kotlin Plugin 최신 버전으로 업데이트

IntelliJ IDEA | Preferences or Settings | Languages & Frameworks | Kotlin에서 Kotlin Plugin 버전을 확인합니다.

이슈가 발생한 환경에서는 203-1.4.10-release-IJ7717.8을 사용하고 있습니다.

Update channel: Stable에서 Check agin하고 Install을 클릭하여 최신 버전으로 업데이트합니다.

IntelliJ IDEA | Preferences or Setttings | Plugins에서 Kotlin을 검색해 최신 버전으로 업데이트 할 수 있습니다.

 웹 브라우저에서 플러그인을 최신화하려면 Jet Brains Marketplace에 들어갑니다.

Kotlin Plugin을 검색하고 Install to IntelliJ IDEA를 클릭합니다.