Android构建React Native应用时Gradle解析react-native-reanimated依赖出错

以下是针对该问题的几种可行修复方案：

1. 替换Gradle仓库镜像（国内环境优先） #

修改项目根目录下的build.gradle文件，将默认仓库替换为国内镜像源，提升依赖下载速度：

buildscript {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
        mavenCentral()
    }
    // 保留原有其他配置
}

allprojects {
    repositories {
        maven { url 'https://maven.aliyun.com/repository/google' }
        maven { url 'https://maven.aliyun.com/repository/jcenter' }
        maven { url 'https://maven.aliyun.com/nexus/content/groups/public' }
        mavenCentral()
        maven { url "$rootDir/../node_modules/react-native/android" }
        maven { url "$rootDir/../node_modules/jsc-android/dist" }
    }
}

2. 清理Gradle缓存后重新构建 #

执行命令清除本地及全局Gradle缓存，避免缓存损坏导致的依赖解析异常：

# 清除项目Gradle缓存
./gradlew cleanBuildCache
# 清除全局Gradle缓存
# macOS/Linux: rm -rf ~/.gradle/caches
# Windows: rd /s /q %USERPROFILE%\.gradle\caches
# 重新启动构建
npx react-native run-android

3. 固定react-native-reanimated版本 #

将package.json中的版本号从^2.13.0改为固定值，避免自动拉取不兼容的小版本：

"react-native-reanimated": "2.13.0"

执行安装命令更新依赖：

npm install
# 或 yarn install

4. 确认Gradle版本兼容性 #

React Native 0.70.1默认适配Gradle 7.3.3，检查项目gradle/wrapper/gradle-wrapper.properties文件：

distributionUrl=https\://services.gradle.org/distributions/gradle-7.3.3-all.zip

若版本不符，修改后重新执行构建。

5. 检查Android SDK配置 #

打开Android Studio的SDK Manager，确认已安装Android SDK Build-Tools 30.0.3（RN 0.70.1所需版本），同时确保ANDROID_HOME环境变量配置正确。

内容的提问来源于stack exchange，提问作者Amin Jafarlou