新增AAR至libs目录执行Sync时报Null extracted folder for artifact错误如何解决

以下是触发的报错原文：

Null extracted folder for artifact: ResolvedArtifact(componentIdentifier=mylib-release-1.13.aar, variantName=null, artifactFile=D:...\app\libs\mylib-release-1.13.aar, extractedFolder=null, dependencyType=ANDROID, isWrappedModule=false, buildMapping={current_build=D:...}, mavenCoordinatesCache=com.android.build.gradle.internal.ide.dependencies.MavenCoordinatesCacheBuildService$Inject@60eddcd6)
该错误由Gradle缓存的依赖提取记录异常、AAR导入配置错误或者多版本同名依赖冲突导致，可按以下步骤修复：

步骤1：清理冲突文件和缓存 #

• 彻底删除libs目录下所有旧版本的mylib-release-x.x.aar包，仅保留需要使用的1.14版本AAR
• 关闭Android Studio，删除项目根目录下的.gradle文件夹、app/build文件夹
• 进入系统全局Gradle缓存目录：
  • Windows路径：C:\Users\<你的系统用户名>\.gradle\caches
  • macOS/Linux路径：~/.gradle/caches
• 删除缓存目录下的transforms文件夹，该目录存储所有依赖的转换提取产物

步骤2：检查AAR依赖配置 #

打开app模块的build.gradle文件，确认存在以下配置：

1. 声明本地libs目录为依赖仓库

repositories {
    flatDir {
        dirs 'libs'
    }
}

2. 依赖引入格式正确，无需加.aar后缀

dependencies {
    implementation(name: 'mylib-release-1.14', ext: 'aar')
}

步骤3：重启并重新同步项目 #

• 重新打开Android Studio，点击菜单栏File -> Invalidate Caches / Restart，选择Invalidate and Restart
• 编辑器重启完成后，点击顶部工具栏的Sync Project with Gradle Files按钮，等待同步完成即可

异常兜底排查 #

如果执行以上操作后问题仍存在，可按以下方向检查：

• 确认使用的AAR包完整未损坏，可尝试重新导出/下载对应版本的AAR文件
• 确认当前项目的Android Gradle Plugin（AGP）版本和AAR的编译AGP版本兼容，版本差异过大时需升级项目AGP版本或者更换匹配版本的AAR

内容的提问来源于stack exchange，提问作者Andrew Efremov