FlutterのGradleエラーは「バージョンの組み合わせ」を疑う|Androidビルドが通らない時の対処法

このページには広告が含まれる場合があります。

 

※この記事は、2026年11月11日に、Flutter・Android・Gradle・Kotlinの公式ドキュメントで確かめた内容です(Flutterの公式ドキュメントは、この時点でFlutter 3.47を前提に書かれています)。バージョンの数字やメニューの名前は変わりやすく、コマンドの動き方も環境によって異なります。

「Android Studioを上げたら、AndroidでFlutterのアプリがビルドできなくなった」

「flutter run すると、Gradleの赤いエラーが出て止まる」

「エラー文に Java や Gradle のバージョンの数字が並んでいて、何を直せばいいのかわからない」

「昨日まで動いてたやん!?」と言いたくなりますよね。

先に答えを書くと、FlutterのGradleエラーの多くは、次の4つの部品の「バージョンの組み合わせ」が合っていないことで起きます。

  1. Java(JDK):Gradleを動かすための土台
  2. Gradle:Androidのビルドを受け持つツール
  3. Android Gradle Plugin(AGP):GradleでAndroidのアプリを作るための部品
  4. Kotlin(Kotlin Gradle Plugin):Kotlinのコードをビルドするための部品

どれか1つだけが新しくなったり、古いまま取り残されたりすると、組み合わせが崩れてビルドが止まります。だから、エラー文から「どの2つが合っていないのか」を見分けて、その組み合わせだけを直すのが近道です。

ぼくも、講座で教えていたころは、ツールやパッケージが変わるたびに教材を書き直していて、2025年の夏には「アップデートを作るの疲れちゃって」とこぼしていたくらいです。Flutterで開発していると、こうしたバージョンの変化とは長い付き合いになります。

 

1. Gradleエラーの正体は、4つの部品の組み合わせ

Flutterのプロジェクトでは、Androidのビルドの設定は android フォルダの中にあります。4つの部品が、どこで決まっているかを先に押さえておくと、エラー文を読んだときに、どのファイルを開けばいいかがすぐわかります。

部品どこで決まるか確かめ方
Java(JDK)何も設定していなければ、Android Studioに入っているJDKflutter doctor -v
Gradleandroid/gradle/wrapper/gradle-wrapper.properties の distributionUrlファイルの中の、URLに入っているバージョン
AGPandroid/settings.gradle の plugins の中の com.android.application同じ行の version
Kotlinandroid/settings.gradle の plugins の中の org.jetbrains.kotlin.android同じ行の version

新しく作ったプロジェクトでは、ファイル名が settings.gradle.kts のように「.kts」で終わっていることがあります。書き方が少し違うだけで、見る場所は同じです。

AGPとKotlinの行は、Flutterの公式ドキュメントの例では、次のような形です({agpVersion} と {kotlinVersion} の所に、実際のバージョンが入ります)。

plugins {
    id "dev.flutter.flutter-plugin-loader" version "1.0.0"
    id "com.android.application" version "{agpVersion}" apply false
    id "org.jetbrains.kotlin.android" version "{kotlinVersion}" apply false
}

ただし、上の表のAGPとKotlinの場所は、Flutter 3.16以降に作ったプロジェクトの場合です。それより前に作ったプロジェクトで、まだ書き方を移していなければ、AGPもKotlinも android/build.gradle の buildscript の中に書かれています。Flutterの公式ドキュメントの例では、次のような形です。

buildscript {
    ext.kotlin_version = '1.7.10'
    ...
    dependencies {
        classpath 'com.android.tools.build:gradle:7.3.0'
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

AGPは classpath 'com.android.tools.build:gradle:〜' の行の最後の数字(この例なら 7.3.0)、Kotlinは ext.kotlin_version の値(この例なら 1.7.10)です。settings.gradle に com.android.application の行が見当たらないときは、こちらを見てください。

どの部品も、1つだけ上げればいいわけではありません。 たとえばJavaを上げると、それを動かせる新しいGradleが要ります。Gradleを上げると、それに合うAGPが要ることがあります。部品どうしが、お互いに「このバージョン以上」「このバージョンまで」と条件を出し合っているんです。

参考:Deprecated imperative apply of Flutter’s Gradle plugins・Required Kotlin version(いずれもFlutter docs、2026年11月11日確認)/Gradle Wrapper(Gradle User Manual、2026年11月11日確認)

 

2. エラー文から「どの組み合わせか」を見分ける

Gradleのエラーは長いですが、組み合わせの問題なら、だいたい決まった言い回しが出てきます。よく出るものを、合っていない組み合わせごとに並べると、次のとおりです。

エラー文(一部)合っていない組み合わせ見る節
Unsupported class file major version 61(や 65)Java が新しすぎて、Gradle が対応していない3
Your project's Gradle version is incompatible with the Java version that Flutter is using for GradleJava と Gradle3
Android Gradle plugin requires Java 17 to run. You are currently using Java 11.Java が古すぎて、AGP が動かない3
Minimum supported Gradle version is x.x. Current version is x.xAGP が求める Gradle より、今の Gradle が古い4
Your project requires a newer version of the Kotlin Gradle plugin.Kotlin が古い5

「major version 61」「65」は、Javaのクラスファイルの版の番号です。Javaの仕様では、61がJava 17、65がJava 21に当たります。つまり「Java 17(や21)で作られたものを、今のGradleが読めない」と言っているんです。

数字が並んでいても、慌てずに「どの部品の名前が出ているか」を見ます。 Java・Gradle・Android Gradle plugin・Kotlinのどれの話なのかがわかれば、開くファイルが決まります。

参考:Android Java Gradle migration guide・Required Kotlin version(いずれもFlutter docs、2026年11月11日確認)/Java versions in Android builds(Android Developers、2026年11月11日確認)/Java Virtual Machine Specification 4章(Oracle、2026年11月11日確認)

 

3. JavaとGradleが合わないとき

Android Studioを上げたあとに出やすいのが、この組み合わせです。Android Studioを上げると、その中に入っているJDKのバージョンも上がることがあります。ところが、プロジェクトのGradleは古いまま。新しいJavaの上では、古いGradleが動けない、というわけです。

FlutterはどのJavaを使っているか

Flutterの公式ドキュメントでは、FlutterがAndroidのアプリをビルドするときに使うJavaは、次の順で決まるとされています。

  1. Android Studioに入っているJDK(何も設定していなければ、これ)
  2. Android Studioが入っていなければ、環境変数 JAVA_HOME のJDK
  3. それもなければ、PATH の通っている java

今どのJavaが使われているかは、flutter doctor -v で確かめられます。

flutter doctor -v

すべてのFlutterのプロジェクトで使うJDKを決めたいときは、次のコマンドでJDKの場所を指定します(SOMEJAVAPATH の所に、JDKのフォルダの場所を入れます。Macなら /usr/libexec/java_home -V で、入っているJDKの一覧が出ます)。

flutter config --jdk-dir=SOMEJAVAPATH

もう1つ、ややこしい所があります。ここまでの話は、flutter run や flutter build でビルドするときに、Flutterが選ぶJavaのことです。これとは別に、android フォルダの中で ./gradlew のようなGradleのコマンドを直接打つと、Gradleは自分でJavaを探します。Androidの公式ドキュメントでは、Android Studioのボタンから Gradle を動かすときは、Android Studioの設定にある JDK が使われ、ターミナルで Gradle のコマンドを打つときは JAVA_HOME(なければ PATH の java)の JDK が使われる、とされています。

このあと出てくる ./gradlew wrapper や ./gradlew --stop も、このGradleのコマンドです。flutter run は通るのに ./gradlew だけがJavaのエラーで止まる(またはその逆)ときは、Flutterが選んだJavaと JAVA_HOME のJavaが違っていないかを疑ってみてください。Android Studioの設定は、Settings → Build, Execution, Deployment → Build Tools → Gradle の「Gradle JDK」で見られます。

Javaのバージョンごとに要るGradle

Gradleの公式の対応表では、Gradleを動かすJavaのバージョンごとに、最低限要るGradleのバージョンが決まっています。Flutterでよく出てくる所を抜き出すと、次のとおりです。

Java要る Gradle(これ以上)
177.3
218.5
259.1.0

Flutterの公式の移行ガイドでも、Android Studio「Flamingo」でJDKが11から17に上がったとき、7.3より前のGradleはJava 17の上で動かせない、と書かれています。

直し方

直し方は2つあります。

1つ目は、Gradleを上げる方法です。 公式の移行ガイドでは、Android Studioなら、android フォルダの一番上の build.gradle を選んで、Tools → AGP Upgrade Assistant を使う方法が紹介されています。コマンドでやるなら、次の2つです。

flutter analyze --suggestions

公式の移行ガイドでは、flutter analyze --suggestions で示されたGradleのバージョン(またはそれより新しいもの)を使うように書かれています。そのうえで、android フォルダの中で、教えてもらったGradleのバージョンを指定します(Windowsでは gradlew.bat を使います)。

cd android
./gradlew wrapper --gradle-version=SOMEGRADLEVERSION

2つ目は、Javaの方を、今のGradleが動けるバージョンにそろえる方法です。 上の flutter config --jdk-dir で、プロジェクトに合うJDKを指定します。ただ、この指定はすべてのFlutterのプロジェクトに効くので、ほかのプロジェクトのビルドにも影響します。公式の移行ガイドの直し方も、中心は1つ目のGradleを上げる方法です。

(Android Studio「Ladybug」でこのエラーが出たときの、画面の流れに沿った直し方は、こちらの記事でも書いていますので、よろしければご覧ください)

参考:Android Java Gradle migration guide(Flutter docs、2026年11月11日確認)/Java versions in Android builds(Android Developers、2026年11月11日確認)/Compatibility Matrix(Gradle User Manual、Gradle 9.9.1の版、2026年11月11日確認)

 

4. AGPとGradleが合わないとき

AGPは、バージョンごとに「これより古いGradleでは動かない」という最低ラインが決まっています。Androidの公式のリリースノートでは、2026年11月11日時点の最新のAGP 9.5は、Gradle 9.6.0以上と、JDK 17以上が要る、とされています。

AGPだけを上げて、Gradleを上げ忘れると、次のようなエラーになります。

Minimum supported Gradle version is x.x. Current version is x.x

「最低限 x.x が要るのに、今は x.x です」という意味なので、前の数字(Minimum supported)まで、Gradleを上げれば、このエラーは消えます。 ただ、Gradleを上げたことで、今度はJavaやKotlinとの組み合わせのエラーが出ることもあります。そのときは、出たエラー文を2の節の表に当てはめて、次の組み合わせを見ます。 直す場所は、android/gradle/wrapper/gradle-wrapper.properties の distributionUrl です。Gradleの公式では、この行は「どのGradleをダウンロードして使うか」を決めるURLで、URLの中にバージョンが入っています。手で書き換えても、上の ./gradlew wrapper --gradle-version=〜 を使っても、同じ所が変わります。

逆に、AGPを上げると、要るJavaも上がることがあります。Androidの公式ドキュメントでは、AGP 8.x はJDK 17が要るとされていて、古いJavaのままだと、次のようなエラーになります。

Android Gradle plugin requires Java 17 to run. You are currently using Java 11.

このときは、3の節に戻って、使うJavaを17以上にします。

(Android Studioの画面で gradle-wrapper.properties を開いて書き換える流れは、こちらの記事で書いています。2021年の記事なので、画面やバージョンの数字は今と違いますが、直す場所は同じです)

参考:Android Gradle plugin release notes・Java versions in Android builds(いずれもAndroid Developers、2026年11月11日確認)/Gradle Wrapper(Gradle User Manual、2026年11月11日確認)

 

5. Kotlinのバージョンが合わないとき

Flutterは、プロジェクトのKotlinが古いと、次のようなメッセージを出します。

[!] Your project requires a newer version of the Kotlin Gradle plugin.

直す場所は、Flutterの公式ドキュメントでは、Flutter 3.16以降に作ったプロジェクトなら android/settings.gradle、それより古いプロジェクトなら android/build.gradle の ext.kotlin_version とされています。1の節の表の、org.jetbrains.kotlin.android の行の version です。

パッケージ(特にAndroid側のコードを持つもの)を足したとたんにビルドが通らなくなり、Kotlinのバージョンを上げたら通った、というのは、初心者がはまりやすい所の1つです。

KotlinとAGP・Gradleの組み合わせ

Kotlinを上げるときも、AGP・Gradleとの組み合わせがあります。Kotlinの公式の対応表から、いくつか抜き出すと、次のとおりです。

Kotlin(KGP)合う Gradle合う AGP
2.2.20〜2.2.217.6.3〜8.147.3.1〜8.11.1
2.3.20〜2.3.217.6.3〜9.3.08.2.2〜9.0.0
2.4.20〜2.4.217.6.3〜9.7.08.5.2〜9.3.1

Kotlinだけを最新にすると、今度はAGPやGradleが範囲から外れることがあります。 上げる前に、今のAGPとGradleが、その行の範囲に入っているかを確かめておくと安心です。

(「Module was compiled with an incompatible version of Kotlin」というエラーのときの例は、2021年にこちらの記事で書いています)

AGP 9に上げるときは、Kotlinの扱いが変わる

もう1つ、2026年ならではの注意があります。

Flutterの公式ドキュメントでは、AGP 9.0.0から、Kotlinの扱いが「AGPに組み込まれたKotlin(built-in Kotlin)」に変わり、これまでの kotlin-android のプラグインを使っているアプリは、移行するまでビルドが通らない、とされています。

  • Flutter 3.44で、AGP 9でも、これまでのKotlinのプラグインを一時的に使えるようにした(gradle.properties の android.builtInKotlin=false)
  • Flutter 3.47から、アプリと使っているパッケージの移行が済んでいれば、android.builtInKotlin=true にできる
  • 使っているパッケージの側が、まだ移行していないこともある

ですから、AGP 9に上げるのは、公式の移行ガイドを読み、使っているパッケージが対応しているかを確かめてからにするのが無難です。

参考:Required Kotlin version・Migrating Flutter Android projects to built-in Kotlin・Built-in Kotlin migration for app developers(いずれもFlutter docs、2026年11月11日確認)/Configure a Gradle project(Kotlin docs、2026年11月11日確認)

 

6. 直すときに気をつけたいこと

組み合わせがわかっても、「で、どれを上げたらええねん!?」と迷うことがあります。直すときに気をつけたいことを、4つ挙げておきます。

  1. 1回に変えるのは1か所だけ

Java・Gradle・AGP・Kotlinを一度に全部上げると、次に出たエラーが、どの変更のせいなのかわからなくなります。1つ変えたら、ビルドして確かめる、を繰り返します。

  1. 要る行のほかは触らない

講座で、ストアに出すために applicationId を変える手順を見せていたとき、namespace も一緒に変えておこうとしたら、アプリが動かなくなったことがあります。その場で謝って、applicationId だけを変えるやり方に戻しました。ビルドの設定ファイルは、ついでに直したくなる行が多いのですが、エラーに関係のある行だけを直すのが安全です。

  1. 公式の道具に、合うバージョンを聞く

自分で数字を探すより、flutter analyze --suggestions や、Android StudioのAGP Upgrade Assistantに聞く方が、組み合わせを外しにくくなります。

  1. 直したのに同じエラーが出たら、前のGradleを止めてみる

Gradleは、ビルドのたびに裏で動く「デーモン」というプロセスを使い回します。公式では、同じバージョンのGradleで立ち上げたデーモンを止めるコマンドとして gradle --stop が紹介されています。Flutterのプロジェクトなら、android フォルダの中で ./gradlew --stop を打ったあと、もう一度ビルドしてみてください。それでも変わらなければ、flutter clean でビルドの残りを片付けるのも1つの手です。

もう1つ、Flutterの公式ドキュメントには、Androidのビルドファイルの中身は、そのアプリを作ったときのFlutterのバージョンに左右されるので、ときどき flutter upgrade してビルドファイルを今の形に保つように、と書かれています。古いプロジェクトを久しぶりに開いてビルドが通らないときは、まず、ビルドファイルの組み合わせが作った当時のままになっていないかを見てみてください。

参考:Gradle Daemon(Gradle User Manual、2026年11月11日確認)/Migrating Flutter Android projects to built-in Kotlin(Flutter docs、2026年11月11日確認)

 

Gradleのエラーで手が止まっている方へ

エラー文から組み合わせの当たりをつけても、Java・Gradle・AGP・Kotlinのどこまで上げれば全部がかみ合うのかを、ひとりで決めきるのは意外と難しいですよね。上げた先で別のエラーが出て、元に戻すべきかで迷うこともあります。

ぼくのFlutterビルドエラー解決(Zoom・60分)では、事前に送っていただいたエラーメッセージとプロジェクトのデータを見たうえで、Zoomの画面共有でビルドを一緒に動かし、エラーをその場で確かめながら、ビルドが通るところまでを目指します。60分の中で解決しきれなかったときも、原因と、この先どう直していけばいいかをお伝えします。よろしければ、お気軽にご相談ください。

 

まとめ

参考:Android Java Gradle migration guide・Required Kotlin version・Deprecated imperative apply of Flutter’s Gradle plugins・Migrating Flutter Android projects to built-in Kotlin(いずれもFlutter docs、2026年11月11日確認)/Java versions in Android builds・Android Gradle plugin release notes(いずれもAndroid Developers、2026年11月11日確認)/Compatibility Matrix・Gradle Wrapper・Gradle Daemon(いずれもGradle User Manual、2026年11月11日確認)/Configure a Gradle project(Kotlin docs、2026年11月11日確認)

何かのお役に立てれば幸いです。

  • FlutterのGradleエラーの多くは、Java(JDK)・Gradle・AGP・Kotlinの「バージョンの組み合わせ」が合っていないことで起きる
  • Gradleは gradle-wrapper.properties の distributionUrl、AGPとKotlinは settings.gradle の plugins(Flutter 3.16より前に作ったプロジェクトは build.gradle の buildscript)で決まる。Javaは、何も設定していなければAndroid StudioのJDK
  • エラー文の「major version 61・65」「incompatible with the Java version」は、JavaとGradleの組み合わせ。61はJava 17、65はJava 21
  • Java 17ならGradle 7.3以上、Java 21ならGradle 8.5以上が要る(Gradleの公式の対応表)
  • 「Minimum supported Gradle version」は、AGPが求めるGradleより今のGradleが古いという意味。前の数字までGradleを上げる
  • AGP 8.x はJDK 17が要る
  • Kotlinが古いときは settings.gradle(古いプロジェクトは build.gradle の ext.kotlin_version)を直す。AGP・Gradleとの組み合わせも確かめる
  • AGP 9からはKotlinの扱いが変わるので、公式の移行ガイドと、パッケージの対応を確かめてから上げる
  • 直すときは、1回に1か所、要る行だけ。合うバージョンは flutter analyze --suggestions やAGP Upgrade Assistantに聞く
  • 直したのに変わらなければ、./gradlew --stop や flutter clean で、前のビルドの残りを片付けてから試す

アプリのリリースでお困りですか?
Google Play・App Storeへのリリース支援サービスをご用意しています。
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。

みんプロ式・アプリ開発支援サービス一覧を見る ↗

こんな記事も読まれています

人気No.1

前向きな気持ちになれる 占星術・タロットリーディング

あすコロ式・相談サロン 【ナビるやん】

人に言えない悩みから使命・運勢診断まで、あなたに寄り添いながら“ナビゲート”する、あすコロ人気No.1のオンライン相談サロン。占星術・心理学・タロットの叡智を活かし、普段認識していない「潜在意識」にアクセスしてあなたの気づいていない可能性を拓かせ、明日から前向きに歩めるようになる60分のリーディングセッション。

今すぐ詳細を見る(メルマガ登録で初回半額) ▶
GAMBO(願望) ✦ 願望実現・目標達成の
17秒 / 68秒ワーク
GAMBO(願望) 引き寄せ難民だったぼくの挫折経験から生まれた誰でもできる願望実現サポートアプリ。かの有名な17秒/68秒ワークを独自の視覚化メソッドで簡単実践。
App Store / Google Play 詳しく見る →
Meiso(瞑想) ◎ 鐘音と自然音で
5分からのマインドフルネス
Meiso(瞑想) 初心者でも“迷わず続けられる”ことにこだわった、完全無料の瞑想アプリ。画面のガイドに従うだけで呼吸のリズムが整い、最短5分から瞑想を実践できます。
App Store / Google Play 詳しく見る →
小学生からの英検®単語 A ふりがな・音声付き
英検単語1日5分トレーニング
小学生からの英検®単語 ありそうでなかった!ふりがな付き英検®単語トレーニングアプリ!1日たった5分!スキマ時間を活用して、英検®頻出単語を効率的に習得。お子様の一人学習にも安心設計。
App Store / Google Play 詳しく見る →
オボエルンジャー ★ レトロゲームで
nバック脳トレ
オボエルンジャー 科学的脳力開発法「Nバック課題」をファミコン風8bitレトロゲームにアレンジした新感覚脳トレアプリ。記憶力・感情コントロール力・集中力の向上に。
App Store / Google Play 詳しく見る →
ゴイコイコイ 語 超高速フラッシュカードで
語彙習得
ゴイコイコイ 日常語1400語を視覚的に学べる、高速読み上げフラッシュカード式の語彙トレーニングアプリ。知育教室で行われるフラッシュカード学習を、家庭で“手軽に・安価に・正確に”再現。
App Store / Google Play 詳しく見る →

TOP