React Native初始化项目运行报:app:checkDebugAarMetadata执行失败错误

• Gradle本地缓存的AAR依赖包下载不完整或已损坏
• Windows系统用户名包含空格（路径C:\Users\ABDUL MANNAN\中间存在空格），低版本Gradle对带空格的路径识别存在兼容问题
• 你当前使用的React Native 0.66版本默认绑定的Flipper调试工具依赖拉取异常

方案一：清理缓存重新构建（优先尝试） #

• 关闭所有Android Studio窗口和React Native相关的终端进程
• 打开资源管理器进入C:\Users\ABDUL MANNAN\.gradle\caches目录，删除整个transforms-3文件夹
• 进入RN项目的android目录，删除.gradle、build文件夹，再进入app子目录删除build文件夹
• 回到项目根目录重新运行npx react-native run-android，触发依赖重新下载和构建

方案二：处理用户名带空格的兼容问题 #

如果方案一执行后依然报错，可选择以下任意一种方式处理：

方式A：修改Gradle全局缓存路径 #

• 打开Windows系统环境变量配置页面，新增系统变量：变量名为GRADLE_USER_HOME，变量值设置为无空格的路径，例如C:\gradle_cache
• 重启电脑让环境变量生效后，重新执行项目构建即可

方式B：临时禁用Flipper调试工具（最快生效） #

• 打开项目android/gradle.properties文件，新增一行配置：FLIPPER_VERSION=0.0.0
• 或者打开android/app/build.gradle文件，找到所有和Flipper相关的debug依赖行，全部注释后重新构建

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