You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Task :app:checkProdDebugAarMetadata 执行失败,React Native 应用无法安装,gradlew clean 无效

React Native Task :app:checkProdDebugAarMetadata FAILED 报错解决方案

该报错通常由项目compileSdk版本与依赖要求版本不匹配导致,可按以下步骤排查修复:

  • 调整compileSdk与targetSdk版本
    打开android/app/build.gradle文件,找到compileSdkVersion与targetSdkVersion配置项,将版本升级至报错提示要求的最低版本,通常为33及以上即可覆盖绝大多数依赖要求。
  • 强制统一核心依赖版本
    打开android/build.gradle文件,在allprojects代码块中添加如下配置,强制指定核心库版本与compileSdk匹配:
    configurations.all {
        resolutionStrategy { 
            force 'androidx.core:core-ktx:1.10.1'
            // 可根据报错提示添加其他需要强制对齐版本的依赖
        }
    }
    
  • 全量清理缓存后重建
    依次执行以下命令清理所有缓存,避免历史缓存干扰:
    1. 删除node_modules并重新安装依赖:rm -rf node_modules && npm install
    2. 进入安卓目录执行清理:cd android && ./gradlew clean
    3. 停止gradle守护进程:./gradlew --stop
    4. 删除安卓目录下的.gradle缓存文件夹
  • 排查新增第三方依赖
    如果报错是在新增某款React Native第三方库后出现,可查看该库的文档要求的最低compileSdk版本,要么升级项目compileSdk适配,要么降级第三方库到适配你当前项目配置的版本。

报错详情截图:
报错详情截图

内容的提问来源于stack exchange,提问作者Zohaib Imtiaz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.04 02:27:03