PC パソコン

Android Studio「A problem occurred evaluating project ‘:app’」の解決方法

Android Studioでプロジェクトを開いたときやGradle Sync、ビルドを実行したときに、
「A problem occurred evaluating project ‘:app’」
というエラーが表示されることがあります。

このエラーは、Gradleが:appモジュールの設定内容を読み込んで評価している途中で、
build.gradleやbuild.gradle.kts、
プラグイン、SDK、依存関係などに問題が見つかった場合に表示されます。

重要なのは、
「A problem occurred evaluating project ‘:app’」自体は具体的な原因を示すエラーではない
という点です。
実際の原因は、その下に表示されている
Caused by:や具体的なエラーメッセージを確認する必要があります。

「A problem occurred evaluating project ‘:app’」とは

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

Androidアプリでは通常、
appモジュールの
build.gradleまたはbuild.gradle.kts
に、SDKバージョン、プラグイン、依存関係などが記述されています。

この設定をGradleが評価している途中で問題が発生すると、
次のようなエラーが表示されます。 

A problem occurred evaluating project ':app'.

ただし、この1行だけでは原因を特定することはできません。
エラー表示のさらに下にある詳細メッセージを確認することが重要です。

まずエラーの詳細を確認する

このエラーが発生した場合は、
Build OutputやGradle Syncのエラー内容を下まで確認します。

たとえば、次のように表示されている場合があります。 

A problem occurred evaluating project ':app'.
> Could not find method ○○○() for arguments [...]

または、 

A problem occurred evaluating project ':app'.
> Failed to apply plugin 'com.android.application'.

この場合、
「A problem occurred evaluating project ‘:app’」よりも、その後に表示されている内容が実際の原因
です。

ポイント：
エラーの先頭部分だけで判断せず、
Caused by:、
Could not、
Failed to、
Could not find method
などの記述を探してください。

原因1：build.gradleの記述ミス

比較的多い原因が、
app/build.gradleやapp/build.gradle.kts
の記述ミスです。

括弧の不足、記述位置の間違い、存在しない設定項目などがあると、
Gradleが:appモジュールを正常に評価できません。

特に、エラーが発生する直前に
build.gradleを編集していた場合は、
変更した部分を最初に確認します。

確認ポイント：
{ }や( )の閉じ忘れ、
スペルミス、
設定項目の記述位置などを確認します。

原因2：GroovyとKotlin DSLの書き方を混同している

Gradleの設定ファイルには主に、
Groovy DSLを使用するbuild.gradleと、
Kotlin DSLを使用するbuild.gradle.ktsがあります。

両者では記述方法が異なるため、
Webサイトなどからコピーした設定をそのまま貼り付けると、
エラーになることがあります。

Groovy DSLの例

compileSdk 36

Kotlin DSLの例

compileSdk = 36

使用しているファイルが
build.gradleなのか
build.gradle.ktsなのかを確認し、
それぞれに対応した書き方を使用してください。

原因3：Android Gradle PluginとGradleのバージョンが合っていない

Android Gradle PluginとGradleには互換性があり、
組み合わせが適切でないとプロジェクトの評価時にエラーが発生することがあります。

Android StudioやAndroid Gradle Pluginだけを更新した場合や、
古いプロジェクトを新しいAndroid Studioで開いた場合などに発生しやすい問題です。

プロジェクトで使用しているAndroid Gradle Pluginと、
gradle-wrapper.propertiesに設定されているGradleのバージョンを確認します。 

gradle/wrapper/gradle-wrapper.properties

このファイル内の
distributionUrlからGradleのバージョンを確認できます。

原因4：プラグインの設定に問題がある

pluginsブロックに指定しているプラグインが見つからない場合や、
プラグインのバージョンに互換性がない場合にもエラーが発生します。 

plugins {
    id 'com.android.application'
}

Kotlin、Google Services、Firebaseなどのプラグインを追加した直後にエラーが発生した場合は、
追加したプラグインの設定やバージョンを確認してください。

原因5：compileSdkなどのSDK設定に問題がある

compileSdkなどで指定しているAndroid SDKが、
パソコンにインストールされていない場合があります。

Android Studioの
SDK Manager
を開き、プロジェクトで指定しているAndroid SDK Platformがインストールされているか確認します。 

android {
    compileSdk 36
}

この例では、対応するAndroid SDKが開発環境に必要です。

原因6：依存関係の記述に問題がある

dependencies内のライブラリ指定に問題がある場合も、
Gradle関連のエラーにつながることがあります。 

dependencies {
    implementation 'グループ名:ライブラリ名:バージョン'
}

ライブラリ名やバージョンのスペルミス、
存在しないバージョンの指定、
古いライブラリとの互換性などを確認します。

原因7：repositoriesの設定に問題がある

必要なライブラリやプラグインを取得するためのリポジトリ設定が不足していると、
Gradleが必要なファイルを取得できない場合があります。

プロジェクトの構成によって異なりますが、
一般的には次のようなリポジトリが使用されます。 

repositories {
    google()
    mavenCentral()
}

古いプロジェクトでは、
現在使用できない、または推奨されていないリポジトリ設定が残っていることもあります。

原因8：local.propertiesやSDKパスに問題がある

Android SDKの場所を示す
local.properties
に問題がある場合、GradleがAndroid SDKを正常に認識できないことがあります。 

sdk.dir=/Users/ユーザー名/Library/Android/sdk

特に、別のパソコンからプロジェクトをコピーした場合や、
Android SDKの保存場所を変更した場合は確認してください。

原因9：Java・JDKのバージョンに問題がある

Android Gradle PluginやGradleが必要とするJavaのバージョンと、
Android Studioが使用しているJDKのバージョンが一致していない場合があります。

Android StudioのGradle設定から、
Gradleで使用されているJDKを確認します。

Android Studioに付属するJDKを使用できる環境では、
特別な理由がなければAndroid Studio側で指定されているJDKを使用することで、
Java環境によるトラブルを避けやすくなります。

原因10：古いGradle設定が残っている

長期間使用しているプロジェクトでは、
古いAndroid Gradle Pluginで使用されていた設定が残っていることがあります。

Android StudioやGradleを更新すると、
以前使用できた設定が非推奨または使用不可になり、
プロジェクトの評価時にエラーになることがあります。

エラーメッセージに
Could not find methodや
Could not get unknown property
などが表示されている場合は、
古いGradle設定が残っていないか確認してください。

Gradle Syncを実行する

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

Android Studioのメニューなどから
Sync Project with Gradle Files
を実行し、プロジェクト設定を再読み込みします。

Syncが正常に終了すれば、
設定ファイルの問題が解決している可能性があります。

Clean ProjectとRebuild Projectを試す

設定を修正してもビルドエラーが残っている場合は、
プロジェクトを一度CleanしてからRebuildします。 

Build
→ Clean Project

Build
→ Rebuild Project

古いビルド結果が原因になっている場合は、
これだけで正常にビルドできることがあります。

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

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

./gradlew assembleDebug --stacktrace

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

gradlew assembleDebug --stacktrace

--stacktraceを付けることで、
エラーが発生した場所や原因をより詳しく確認できます。

キャッシュが原因の場合

GradleやAndroid Studioのキャッシュに問題が発生している場合、
設定自体が正しくてもエラーが残ることがあります。

Android Studioを再起動し、
Gradle Syncをやり直します。

それでも改善しない場合は、
Android Studioのキャッシュ関連機能を利用して再起動する方法もあります。

キャッシュ削除は最初に行う対処ではありません。
まずエラーメッセージを確認し、
build.gradleやプラグイン、SDK、JDKなどの設定に問題がないことを確認してから試す方が、
原因を特定しやすくなります。

変更直前の状態に戻して確認する

プラグインやライブラリを追加した直後、
またはGradleファイルを編集した直後からエラーが発生した場合は、
変更した部分を一度元に戻してみる方法が有効です。

元に戻した状態でGradle Syncが成功すれば、
直前に追加・変更した設定が原因である可能性が高くなります。

解決できない場合に確認する項目

「A problem occurred evaluating project ‘:app’」が解決しない場合は、
次の順番で確認すると原因を絞り込みやすくなります。

  1. エラーの下に表示されている詳細メッセージを確認する
  2. app/build.gradleまたはapp/build.gradle.ktsの記述を確認する
  3. Groovy DSLとKotlin DSLを混同していないか確認する
  4. 直前に追加したプラグインやライブラリを確認する
  5. Android Gradle PluginとGradleのバージョンを確認する
  6. compileSdkなどに対応するAndroid SDKがインストールされているか確認する
  7. Gradleで使用するJDKを確認する
  8. Gradle Syncを実行する
  9. Clean Project、Rebuild Projectを実行する
  10. --stacktraceを付けてGradleを実行する

まとめ

Android Studioの
「A problem occurred evaluating project ‘:app’」
は、
Gradleが:appモジュールの設定を評価している途中で問題が発生したことを示すメッセージです。

このメッセージだけでは具体的な原因は分からないため、
その下に表示されている詳細なエラー内容を確認することが最も重要です。

特に、
build.gradleやbuild.gradle.ktsの記述ミス、
Android Gradle PluginとGradleの互換性、
プラグイン、
SDK、
JDK、
依存関係などを確認してください。

エラーが発生する直前に設定を変更している場合は、
その変更箇所から確認すると原因を早く特定できる可能性があります。

Amazon.co.jpで関連する書籍や商品を見る
スポンサーリンク