切换工作目录到G盘后React Native项目报错Task :app:installDebug FAILED

核心诱因 #

• 项目级缓存路径不匹配：原有存放在C盘的项目，其node_modules依赖目录、Android构建缓存目录（android/.gradle、android/build）内存在大量硬编码的C盘绝对路径，跨盘符移动到G盘后路径全部失效，构建过程中找不到对应资源导致Task :app:installDebug FAILED报错。新创建的项目所有缓存和路径都是基于G盘生成，因此可以正常运行。
• 跨盘符权限不兼容：Windows系统下不同盘符的文件夹权限规则相互独立，从C盘复制到G盘的项目会继承原有C盘的权限配置，若G盘的项目存放目录未给当前用户开放读写、执行权限，Android构建工具无法写入临时构建产物、安装包文件，就会触发安装调试包的失败报错。直接在G盘新建的项目会自动继承当前操作的正常权限，因此不会出现权限问题。
• 本地专属配置失效：旧项目中存在和本地环境绑定的配置文件（如android/local.properties中硬编码的SDK路径、自定义的.env本地配置），这些配置是基于C盘项目路径生成，移动到G盘后配置和实际环境不匹配，触发构建失败。
• 依赖符号链接失效：如果原有项目的依赖是通过软链接/符号链接方式安装，跨盘符移动后符号链接全部失效，node_modules内的依赖引用异常，导致JS资源打包失败，最终触发安装任务失败。

存在的操作错误 #

• 移动项目前未清理环境相关文件：跨盘符移动项目前没有删除node_modules、android/.gradle、android/build、ios/build、local.properties等和当前路径、环境绑定的缓存及配置文件，直接移动导致旧配置失效引发报错。
• 未校验目标目录权限：切换工作盘前没有确认G盘存放项目的目录对当前用户开放了完整的读写、修改权限，导致构建工具运行时权限不足。
• 克隆新项目时未做环境适配：在G盘新克隆Github项目后，直接执行npx react-native run-android运行命令，没有先重新安装依赖、生成适配当前G盘路径的本地配置，触发和旧项目一样的路径不匹配问题。

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