Android Studio安装成功但构建失败无法运行，求解决AAR依赖兼容问题

• 统一项目与AAR的编译配置
  检查项目build.gradle(Module)中的compileSdkVersion、targetSdkVersion是否与AAR要求的版本一致。如果AAR是基于较高版本SDK编译的，需同步升级项目的对应版本，避免API不兼容。

• 排查并解决依赖冲突
  执行命令./gradlew app:dependencies生成依赖树，找出重复依赖或版本冲突的库。通过以下两种方式处理：

  • 在依赖声明中排除冲突模块：

    implementation(name: 'your-aar-file', ext: 'aar') {
        exclude group: 'com.example.conflict', module: 'conflict-lib'
    }
    

  • 强制统一冲突库的版本：

    configurations.all {
        resolutionStrategy {
            force 'com.example.conflict:conflict-lib:1.0.0'
        }
    }
    

• 验证AAR本身的兼容性
  解压AAR文件，查看内部AndroidManifest.xml和依赖配置，确认其是否依赖已废弃的库、是否限制了特定CPU架构。若存在此类问题，需更换兼容版本的AAR，或调整项目的架构配置（比如在build.gradle(Module)中添加ndk.abiFilters匹配AAR支持的架构）。

• 清理缓存而非重装软件
  无需重装Android Studio和Java。直接通过以下步骤清理缓存：

  1. 点击AS菜单栏File > Invalidate Caches...
  2. 勾选Invalidate and Restart选项后重启AS
     也可手动删除项目根目录的.gradle文件夹和模块下的build文件夹，再重新构建项目。

• 确认Java版本兼容性
  Android Studio自带适配的JDK，无需单独安装。检查gradle.properties中的org.gradle.java.home是否指向AS自带的JDK路径，同时确保gradle插件版本与JDK版本匹配（例如gradle 8.0及以上需搭配JDK 17）。

内容的提问来源于stack exchange，提问作者John Obure