React Native正式包构建失败：找不到com.facebook.react:react-android:0.76.7

问题现象 #

Debug构建可正常运行，但执行发布构建命令时失败：

cd android && ./gradlew assembleRelease

核心报错信息：

* Exception is:
org.gradle.api.internal.tasks.TaskDependencyResolveException: Could not determine the dependencies of task ':app:lintVitalReportRelease'.
        at org.gradle.api.internal.tasks.CachingTaskDependencyResolveContext.getDependencies(CachingTaskDependencyResolveContext.java:70)

        at org.gradle.internal.concurrent.AbstractManagedExecutor$1.run(AbstractManagedExecutor.java:48)
Caused by: org.gradle.api.internal.artifacts.ivyservice.TypedResolveException: Could not resolve all dependencies for configuration ':app:releaseCompileClasspath'.

Caused by: org.gradle.internal.resolve.ModuleVersionNotFoundException: Could not find com.facebook.react:react-android:0.76.7.
Required by:
    project :app

已尝试的排查步骤 #

• 确认package.json中React Native依赖版本为0.76.7
• 删除node_modules和package-lock.json后重新执行npm install
• 进入android目录，删除.gradle文件夹，执行./gradlew clean和./gradlew --refresh-dependencies后重建
• 检查android/build.gradle中的仓库配置，已配置google()、mavenCentral()及com.facebook.react的本地仓库
• 验证app/build.gradle中已正确引入com.facebook.react:react-android依赖

解决方案 #

1. 补充Meta Maven仓库配置 #

React Native 0.76+版本需要额外配置Meta的官方Maven仓库，仅靠本地仓库可能无法拉取release依赖。在android/build.gradle的allprojects.repositories块中添加：

allprojects {
    repositories {
        // 保留已有的google()、mavenCentral()
        maven {
            url "https://maven.facebook.com"
        }
        // 本地仓库配置保留
        maven {
            url "$rootDir/../node_modules/react-native/android"
        }
        maven {
            url "$rootDir/../node_modules/jsc-android/dist"
        }
    }
}

2. 校验gradle.properties版本一致性 #

确保android/gradle.properties中没有硬编码的冲突版本，或者版本与package.json完全匹配：

reactNativeVersion=0.76.7

3. 彻底清理缓存并重新同步 #

执行以下命令完成全链路清理：

# 清理npm缓存
npm cache clean --force
# 删除依赖文件与锁文件
rm -rf node_modules package-lock.json
# 重新安装npm依赖
npm install
# 进入android目录清理gradle缓存
cd android
rm -rf .gradle build
./gradlew clean
./gradlew --refresh-dependencies
# 重新构建release包
./gradlew assembleRelease

4. 检查本地react-android包完整性 #

查看node_modules/react-native/android/com/facebook/react/react-android目录，确认存在0.76.7版本的aar文件。若缺失，删除node_modules重新安装即可。

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