Android Studio「Could not compile build file」の原因と解決方法

「Could not compile build file」とは

Android Studioでは、アプリをビルドする前にGradleがプロジェクトの設定ファイルを読み込みます。

代表的な設定ファイルには、次のようなものがあります。

• build.gradle
• build.gradle.kts
• settings.gradle
• settings.gradle.kts

これらのファイルに構文上の問題があると、
Gradleがファイルを正常に処理できず、
次のようなエラーが表示されることがあります。

Could not compile build file

実際には、その後に対象となるファイル名や行番号、
具体的なエラー内容が表示されることが多いため、
「Could not compile build file」の部分だけで判断しないことが重要です。

まずエラーが発生しているファイルと行番号を確認する

「Could not compile build file」が表示された場合は、
エラーの直後に表示されているファイル名と行番号を確認します。

Could not compile build file '/project/app/build.gradle'.

startup failed:
build file '/project/app/build.gradle': 42:
Unexpected input: '}'

このような場合は、
app/build.gradleの42行目前後に問題がある可能性があります。

原因1：括弧の閉じ忘れ

よくある原因のひとつが、
{ }や( )などの括弧の閉じ忘れです。

android {
    compileSdk 36

    defaultConfig {
        applicationId "com.example.app"
        minSdk 23
        targetSdk 36
}

この例では、
defaultConfigやandroidブロックを閉じるための
}が不足しています。

Gradleファイルでは複数のブロックが入れ子になるため、
括弧がひとつ不足しただけでも、
ファイル全体を正常に解析できなくなる場合があります。

原因2：引用符の閉じ忘れ

文字列を囲む
"や'
の閉じ忘れでもエラーが発生します。

applicationId "com.example.app

正しくは、文字列の最後まで引用符で囲みます。

applicationId "com.example.app"

ライブラリの依存関係を追加した際にも、
引用符の閉じ忘れが起こることがあります。

原因3：Groovy DSLとKotlin DSLを混同している

Android StudioのGradle設定には、
主にGroovy DSLとKotlin DSLがあります。

build.gradleはGroovy DSL、
build.gradle.ktsはKotlin DSLとして記述します。

両者では文法が異なるため、
Webサイトなどからコピーしたコードをそのまま貼り付けると、
「Could not compile build file」が発生することがあります。

android {
    compileSdk 36
}

android {
    compileSdk = 36
}

使用しているファイルの拡張子を確認し、
適切な記述方法を使用してください。

原因4：記述する場所を間違えている

Gradleでは、設定項目ごとに記述するブロックが決まっています。

正しい設定項目でも、
本来とは異なる場所に記述するとエラーになる場合があります。

android {
    defaultConfig {
        applicationId "com.example.app"
    }
}

dependencies {
    implementation 'androidx.appcompat:appcompat:1.x.x'
}

たとえば、
implementationは通常
dependenciesブロック内に記述します。

エラーが発生する直前に新しい設定を追加している場合は、
その設定を記述した場所も確認してください。

原因5：余計な文字が入っている

コードをコピーして貼り付けた際に、
不要な文字や記号が混入することがあります。

compileSdk 36,

本来不要なカンマや記号が含まれていると、
Gradleが構文を解釈できない場合があります。

エラーメッセージに
Unexpected input、
Unexpected character、
Unexpected token
などが表示されている場合は、
エラー行付近に余計な文字がないか確認します。

原因6：プラグインの記述方法に問題がある

pluginsブロックを編集した直後に、
「Could not compile build file」が発生することもあります。

plugins {
    id 'com.android.application'
}

Kotlin DSLの場合は記述方法が異なります。

plugins {
    id("com.android.application")
}

プラグインの追加方法を確認するときは、
自分のプロジェクトがGroovy DSLなのかKotlin DSLなのかを確認してください。

原因7：dependenciesの記述ミス

新しいライブラリを追加した直後にエラーが発生した場合は、
dependenciesブロックを確認します。

dependencies {
    implementation 'androidx.appcompat:appcompat:1.x.x'
}

引用符や括弧が不足していたり、
Kotlin DSL用のコードをGroovy DSLに貼り付けたりすると、
ビルドファイルそのものを解析できなくなる場合があります。

原因8：古いGradleの記述が残っている

古いAndroid StudioやAndroid Gradle Pluginで作成されたプロジェクトでは、
現在の環境では使用できない書き方が残っている場合があります。

特に、Android StudioやGradleを更新した直後にエラーが発生した場合は、
古い設定が原因になっていないか確認します。

エラーメッセージに、
使用できないメソッドやプロパティについての表示が出ている場合は、
その設定が現在使用しているGradleやAndroid Gradle Pluginに対応しているか確認してください。

原因9：build.gradleを編集した直後の記述ミス

エラーが突然発生した場合は、
直前に行った変更を確認する方法が非常に有効です。

たとえば、次のような操作をした直後であれば、
その変更部分から確認します。

• ライブラリを追加した
• プラグインを追加した
• compileSdkを変更した
• minSdkやtargetSdkを変更した
• 署名設定を追加した
• Firebaseなどの設定を追加した
• WebサイトからGradleコードをコピーした

変更した部分を一度元に戻してGradle Syncを実行し、
エラーが消えるか確認すると原因を特定しやすくなります。

エラーの行番号の直前も確認する

Gradleの構文エラーでは、
実際に間違っている場所と、
エラーとして表示される行番号が一致しない場合があります。

たとえば、20行目で引用符を閉じ忘れていると、
Gradleがその後のコードを読み続け、
25行目で初めて構文上の矛盾を検出することがあります。

Gradle Syncを実行する

build.gradleや
build.gradle.ktsを修正した後は、
Gradle Syncを実行します。

Android Studioから
Sync Project with Gradle Files
を実行し、
Gradle設定を再読み込みしてください。

構文上の問題が解決していれば、
Syncが正常に完了する可能性があります。

コマンドからGradleを実行して確認する

Android Studio上のエラー表示だけでは原因を確認しにくい場合は、
TerminalからGradleを実行すると、
より詳しい情報を確認できます。

./gradlew assembleDebug --stacktrace

Windowsの場合は、環境によって次のように実行します。

gradlew assembleDebug --stacktrace

--stacktraceを付けることで、
エラーの詳細や発生箇所を確認しやすくなります。

Clean ProjectやRebuild Projectは有効か

「Could not compile build file」は、
Gradle設定ファイル自体の解析段階で発生していることが多いため、
構文ミスが残ったままでは
Clean ProjectやRebuild Projectを実行しても解決しません。

まずビルドファイルの記述を修正し、
Gradle Syncが正常に完了する状態にすることが重要です。

設定ファイルを修正した後も別のビルドエラーが残る場合には、
Clean ProjectやRebuild Projectを試すことができます。

キャッシュを削除する前に確認すること

Android Studioのトラブルではキャッシュ削除が紹介されることがありますが、
「Could not compile build file」の場合は、
まずGradleファイルの構文を確認することをおすすめします。

括弧の不足や記述ミスは、
キャッシュを削除しても修正されません。

「Could not compile build file」が出たときの確認順序

原因が分からない場合は、
次の順番で確認すると問題を絞り込みやすくなります。

1. エラーに表示されているファイル名を確認する
2. エラーに表示されている行番号を確認する
3. 該当行だけでなく、その直前の数行も確認する
4. { }や( )の閉じ忘れを確認する
5. 引用符の閉じ忘れを確認する
6. 不要なカンマや記号がないか確認する
7. Groovy DSLとKotlin DSLを混同していないか確認する
8. 直前に追加したプラグインやライブラリを確認する
9. 変更部分を一度元に戻して確認する
10. Gradle Syncを実行する
11. 必要に応じて--stacktraceで詳細を確認する

まとめ

Android Studioの
「Could not compile build file」
は、
Gradleがbuild.gradleや
build.gradle.ktsなどの設定ファイルを
正常に解析・コンパイルできなかった場合に表示されるエラーです。

特に多いのは、
括弧や引用符の閉じ忘れ、
記述位置の間違い、
Groovy DSLとKotlin DSLの混同、
コピーしたコードの構文ミスなどです。

エラーが表示された場合は、
「Could not compile build file」というメッセージだけではなく、
その後に表示される
対象ファイル、行番号、具体的なエラー内容
を確認してください。

また、エラーの行番号は実際の原因と完全には一致しない場合があるため、
該当行の直前まで含めて確認すると、
問題を見つけやすくなります。