React Native 0.61.5(AndroidX)构建报错：Gradle工件提取文件夹为空

AI 小北

2026-6-30

解决Android构建时"Null extracted folder for artifact"错误（React Native 0.61.5 + AndroidX）

以下是针对你遇到的androidx.annotation:annotation-experimental:1.4.0提取文件夹为空问题的可行解决方案：

彻底清除Gradle缓存
除了常规清理，直接删除全局Gradle缓存目录，强制重新下载所有依赖：
```
rm -rf ~/.gradle/caches
```
再执行项目内清理：
```
cd android && ./gradlew clean
```

强制统一依赖版本
打开android/build.gradle，在allprojects块内添加依赖版本强制策略，避免版本冲突导致的提取异常：

allprojects {
    repositories {
        // 保留现有仓库配置
    }
    configurations.all {
        resolutionStrategy.force 'androidx.annotation:annotation-experimental:1.4.0'
    }
}

检查并修复文件权限
确保Gradle缓存目录的读写权限属于当前用户，权限不足会导致Gradle无法正常提取aar文件：
```
chmod -R 755 ~/.gradle/caches
```
升级Gradle及插件版本
React Native 0.61.5默认的Gradle版本存在兼容性问题，尝试升级到匹配的稳定版本：
1. 修改android/build.gradle中的插件版本：
```
buildscript {
    dependencies {
        classpath 'com.android.tools.build:gradle:4.0.1'
        // 其他依赖保持不变
    }
}
```
2. 修改android/gradle/wrapper/gradle-wrapper.properties中的Gradle版本：
```
distributionUrl=https\://services.gradle.org/distributions/gradle-6.1.1-all.zip
```
重新构建项目
完成上述操作后，在Android Studio中执行File > Sync Project with Gradle Files，然后运行构建命令：
```
./gradlew assembleDebug
```