IntelliJ/Java/Gradle プロジェクトのビルドエラーを解決する方法：Java のバージョンを確認します

2024/09/15

IntelliJ IDEA で Java プロジェクトをビルドすると、エラーが発生することがあります。このようなとき、Java のバージョン設定に問題がある可能性があります。

解決のためには、次の3つを確認しましょう：

STEP 1：プロジェクトの JDK バージョンを確認する

ビルドに Gradle を使用している場合は、build.gradle にプロジェクトで使用する JDK のバージョンが記述されています。下記の手順で確認してください

プロジェクトのルートディレクトリにある build.gradle ファイルを開く
toolchain または sourceCompatibility と targetCompatibility の設定を確認する。以下のように書かれていれば、Java 17 を使用していることがわかります。

java {
  toolchain {
    languageVersion = JavaLanguageVersion.of(17)
  }
}

java {
    sourceCompatibility = '17'
    targetCompatibility = '17'
}

IntelliJ がプロジェクトをビルドする際に使用する JDK のバージョンを確認します。これは、先ほど build.gradle で指定した JDK のバージョンと一致している必要があります。

IntelliJ が Gradle を使用してプロジェクトをビルドする際の設定を確認します。

Build, Execution, Deployment > Build Tools > Gradle を選択する
上記画面で、以下の項目の設定を確認する
- Gradle > Distribution … Wrapper
- Gradle > Gradle JVM … Project SDK

ここまでの内容を反映して、再ビルドするとほとんどの場合でエラーが解消されているはずです。もし、解消されない場合は、以下の記事を参考に IntelliJ のキャッシュをクリアしてみてください：

IntelliJ で Java プロジェクトをビルドする際にエラーが発生した場合、JDK のバージョン設定に問題がある可能性があります。この記事では、次の3つを確認する方法を紹介しました：