Android Studio 3.1.2中Gradle同步失败问题求解

Hey Vijay, sorry to hear you're hitting Gradle sync issues with your Android Studio 3.1.2 setup—mixing different Build Tools versions can definitely throw off the sync process, so let's walk through the most common fixes step by step:

1. Double-Check Your Build Configuration Files #

First, make sure your project and module-level build.gradle files are using compatible versions:

• Project-level build.gradle: Confirm you're using the Gradle plugin version that matches Android Studio 3.1.2. This should be com.android.tools.build:gradle:3.1.2—mismatched plugin versions are a top cause of sync failures.

  buildscript {
      repositories {
          google()
          jcenter()
      }
      dependencies {
          classpath 'com.android.tools.build:gradle:3.1.2' // Must match AS 3.1.2
      }
  }
  

• Module-level build.gradle: Ensure your buildToolsVersion aligns with your compileSdkVersion, and that the version you're referencing is actually installed. For example:
  • If using buildToolsVersion "27.1.1", set compileSdkVersion 27
  • If using buildToolsVersion "21.1", set compileSdkVersion 21

  android {
      compileSdkVersion 27
      buildToolsVersion "27.1.1"
      // Rest of your config...
  }
  

  If you're working with a multi-module project, make sure there's no conflicting versions across modules.

2. Clear Android Studio Caches and Restart #

Corrupted caches are another frequent culprit. Do this:

• Go to File > Invalidate Caches / Restart
• Select Invalidate and Restart—let Android Studio fully restart, then try syncing again.

3. Verify SDK Manager Setup #

Make sure both Build Tools versions and their corresponding platform packages are installed:

• Open Tools > SDK Manager > SDK Tools
• Check the boxes for Android SDK Build-Tools 21.1 and 27.1.1 (if they aren't already checked, click Apply to install them)
• Also confirm the Android SDK Platform for versions 21 and 27 are installed (Build Tools need matching platform support to work)

4. Fix Gradle Wrapper Version #

Your Gradle wrapper version needs to be compatible with the Gradle plugin. For plugin 3.1.2, use a Gradle version between 4.4 and 4.10.2. Check gradle/wrapper/gradle-wrapper.properties:

distributionUrl=https\://services.gradle.org/distributions/gradle-4.6-all.zip // Compatible with 3.1.2 plugin

5. Resolve Dependency Conflicts (Multi-Module Projects) #

If you have modules using different Build Tools versions, you might run into conflicts. To enforce a single version across all modules, add this to your project-level build.gradle:

subprojects {
    afterEvaluate { project ->
        if (project.hasProperty("android")) {
            android {
                buildToolsVersion "27.1.1" // Or 21.1, whichever fits your project needs
            }
        }
    }
}

Alternatively, ensure each module's compileSdkVersion and buildToolsVersion are properly aligned to avoid mismatches.

6. Use the Sync Error Log to Debug #

When sync fails, check the Build panel at the bottom of Android Studio—it will show specific error messages (like "Failed to find Build Tools revision 21.1" or dependency conflicts). Use these messages to target your fix:

• If it says a Build Tools version is missing, go back to SDK Manager to install it
• For dependency conflicts, run ./gradlew dependencies in the terminal to generate a dependency tree, then exclude conflicting libraries as needed.

If none of these steps work, feel free to share the exact error message from the Build panel, and we can dig deeper!

内容的提问来源于stack exchange，提问作者Vijay Kumar