Troubleshooting Android Studio Error: '6 issues were found when checking AAR metadata'

Published on 2023.11.17

If you are an Android developer using Android Studio, you may encounter the following error message: '6 issues were found when checking AAR metadata'. This error can occur when trying to build your project or when importing a library. In this article, we will explore the possible causes for this error and provide step-by-step solutions to help you troubleshoot and resolve it.

Common causes for the error

  1. Mismatched Gradle versions

One of the common causes for this error is mismatched Gradle versions. If your project's build.gradle file and the library you are using have different Gradle versions, it can trigger this error. Make sure to check and update the Gradle versions to ensure compatibility.

  1. Conflicting dependencies

Another reason for this error is conflicting dependencies. If you have multiple libraries or modules that depend on different versions of the same library, it can lead to conflicts and trigger this error. You will need to resolve these conflicts by managing the dependencies effectively.

  1. Corrupted or incompatible AAR file

Sometimes, the AAR file itself can be corrupted or incompatible with your project. This can be due to various reasons like incomplete downloads or incorrect packaging. In such cases, you may need to re-download or obtain a compatible version of the AAR file.

Step-by-step solutions

Solution 1: Check and update Gradle versions

To resolve the Gradle version mismatch, follow these steps:

  1. Open your project in Android Studio.
  2. Navigate to the project's build.gradle file.
  3. Look for the 'dependencies' block.
  4. Update the 'classpath' version to match the library's Gradle version.

Solution 2: Resolve conflicting dependencies

To resolve conflicting dependencies, follow these steps:

  1. Open your project in Android Studio.
  2. Navigate to the project's build.gradle file.
  3. Look for the 'dependencies' block.
  4. Analyze the dependencies and identify the conflicting libraries.
  5. Use the 'exclude' keyword to exclude the conflicting library from the dependency.
  6. Add the specific version of the library you want to use.

Solution 3: Obtain a compatible AAR file

To obtain a compatible AAR file, follow these steps:

  1. Check the official documentation or repository for the library you are using.
  2. Download the appropriate AAR file version for your project.
  3. Replace the existing AAR file with the newly downloaded one.


The '6 issues were found when checking AAR metadata' error in Android Studio can be frustrating, but it is usually caused by relatively simple issues like Gradle version mismatches or conflicting dependencies. By following the step-by-step solutions provided in this article, you should be able to troubleshoot and resolve this error. Remember to keep your dependencies updated and ensure compatibility between libraries to avoid such errors in the future.