※この記事は、2026年11月11日に、Flutter・Android・Gradle・Kotlinの公式ドキュメントで確かめた内容です(Flutterの公式ドキュメントは、この時点でFlutter 3.47を前提に書かれています)。バージョンの数字やメニューの名前は変わりやすく、コマンドの動き方も環境によって異なります。
「Android Studioを上げたら、AndroidでFlutterのアプリがビルドできなくなった」
「flutter run すると、Gradleの赤いエラーが出て止まる」
「エラー文に Java や Gradle のバージョンの数字が並んでいて、何を直せばいいのかわからない」
「昨日まで動いてたやん!?」と言いたくなりますよね。
先に答えを書くと、FlutterのGradleエラーの多くは、次の4つの部品の「バージョンの組み合わせ」が合っていないことで起きます。
- Java(JDK):Gradleを動かすための土台
- Gradle:Androidのビルドを受け持つツール
- Android Gradle Plugin(AGP):GradleでAndroidのアプリを作るための部品
- Kotlin(Kotlin Gradle Plugin):Kotlinのコードをビルドするための部品
どれか1つだけが新しくなったり、古いまま取り残されたりすると、組み合わせが崩れてビルドが止まります。だから、エラー文から「どの2つが合っていないのか」を見分けて、その組み合わせだけを直すのが近道です。
ぼくも、講座で教えていたころは、ツールやパッケージが変わるたびに教材を書き直していて、2025年の夏には「アップデートを作るの疲れちゃって」とこぼしていたくらいです。Flutterで開発していると、こうしたバージョンの変化とは長い付き合いになります。
もくじ
1. Gradleエラーの正体は、4つの部品の組み合わせ
Flutterのプロジェクトでは、Androidのビルドの設定は android フォルダの中にあります。4つの部品が、どこで決まっているかを先に押さえておくと、エラー文を読んだときに、どのファイルを開けばいいかがすぐわかります。
| 部品 | どこで決まるか | 確かめ方 |
|---|---|---|
| Java(JDK) | 何も設定していなければ、Android Studioに入っているJDK | flutter doctor -v |
| Gradle | android/gradle/wrapper/gradle-wrapper.properties の distributionUrl | ファイルの中の、URLに入っているバージョン |
| AGP | android/settings.gradle の plugins の中の com.android.application | 同じ行の version |
| Kotlin | android/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 Gradle | Java と Gradle | 3 |
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.x | AGP が求める 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は、次の順で決まるとされています。
- Android Studioに入っているJDK(何も設定していなければ、これ)
- Android Studioが入っていなければ、環境変数
JAVA_HOMEのJDK - それもなければ、
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(これ以上) |
|---|---|
| 17 | 7.3 |
| 21 | 8.5 |
| 25 | 9.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=SOMEGRADLEVERSION2つ目は、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.21 | 7.6.3〜8.14 | 7.3.1〜8.11.1 |
| 2.3.20〜2.3.21 | 7.6.3〜9.3.0 | 8.2.2〜9.0.0 |
| 2.4.20〜2.4.21 | 7.6.3〜9.7.0 | 8.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か所だけ
Java・Gradle・AGP・Kotlinを一度に全部上げると、次に出たエラーが、どの変更のせいなのかわからなくなります。1つ変えたら、ビルドして確かめる、を繰り返します。
- 要る行のほかは触らない
講座で、ストアに出すために applicationId を変える手順を見せていたとき、namespace も一緒に変えておこうとしたら、アプリが動かなくなったことがあります。その場で謝って、applicationId だけを変えるやり方に戻しました。ビルドの設定ファイルは、ついでに直したくなる行が多いのですが、エラーに関係のある行だけを直すのが安全です。
- 公式の道具に、合うバージョンを聞く
自分で数字を探すより、flutter analyze --suggestions や、Android StudioのAGP Upgrade Assistantに聞く方が、組み合わせを外しにくくなります。
- 直したのに同じエラーが出たら、前の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で、前のビルドの残りを片付けてから試す
ビルドエラー解決・動作確認・申請代行まで、現役開発者が対応します。








