安装react-native-video后安卓运行报checkDebugAarMetadata错误如何解决？

数据老陈

2026-9-30

问题报错详情

任务:app:checkDebugAarMetadata执行失败
无法解析配置:app:debugRuntimeClasspath的所有文件，找不到com.yqritc:android-scalablevideoview:1.0.4依赖，该依赖由project :app > project :react-native-video所需。

解决方案

方案1：补充jcenter仓库（最快生效）

该依赖包仅在jcenter仓库托管，你需要在项目根gradle配置中补充仓库地址：

打开项目android/build.gradle文件
找到allprojects > repositories配置段，在最前面添加jcenter地址：

allprojects {
    repositories {
        // 新增以下配置
        maven { url 'https://jcenter.bintray.com/' }
        // 原有配置不变，比如google()、mavenCentral()等
    }
}

方案2：升级依赖版本（长期修复）

react-native-video 5.x版本依赖该废弃包，升级到6.0+版本即可移除该依赖：

执行卸载旧版本命令：
npm uninstall react-native-video
安装最新稳定版：
npm install react-native-video@^6.0.0

注意：react-native-video-controls 2.8.1仅适配v5版本的react-native-video，升级后可安装适配v6的react-native-video-controls@^3.0.0版本。

方案3：依赖重定向（不想加jcenter可选）

如果不想引入废弃的jcenter仓库，可以添加依赖重定向规则：

打开android/build.gradle，在allprojects块上方添加以下配置：

configurations.all {
    resolutionStrategy.eachDependency { details ->
        if (details.requested.group == 'com.yqritc' && details.requested.name == 'android-scalablevideoview') {
            details.useTarget 'com.github.MatrixFrog:Android-ScalableVideoView:v1.0.4'
        }
    }
}