React Native项目在模拟器运行时报app安装失败错误，重装Android Studio仍未解决

错误详情：Command failed: ./gradlew app:installDebug -PreactNativeDevServerPort=8081

常见原因及对应处理方案 #

• Gradle依赖或缓存异常
  项目Gradle版本和本地Android构建工具版本不兼容，或者依赖包因为网络问题下载不完整，是最常见的触发原因。
  先进入项目android目录执行清理命令./gradlew clean，清除旧的构建缓存后再重新执行运行命令即可。
• Android环境变量配置错误
  仅安装Android Studio不代表环境变量配置正确，若ANDROID_HOME变量缺失，或者SDK的tools、platform-tools目录未加入系统PATH，构建过程会无法调用对应工具。
  检查系统环境变量，确认ANDROID_HOME指向你的Android SDK安装路径，同时将SDK目录下的emulator、platform-tools、tools三个子目录都加入系统PATH变量中，配置完成后重启终端生效。
• 设备连接或状态异常
  当前运行的模拟器未被adb正常识别，或者模拟器内部存储空间不足都会导致安装失败。
  执行adb devices查看已连接设备列表，若没有你运行中的模拟器，可执行adb kill-server && adb start-server重启adb服务后重试；同时检查模拟器剩余存储空间，至少预留2G以上的可用空间用于安装应用。
• 端口占用冲突
  React Native默认使用的8081端口被其他进程占用时，也会导致该构建命令失败。
  Mac/Linux系统执行lsof -i :8081、Windows系统执行netstat -ano | findstr 8081即可查询占用8081端口的进程，结束对应进程后重新运行即可，也可以在启动时指定其他端口规避冲突。
• 原生配置修改错误
  如果你修改过android目录下的配置文件、新增了第三方原生依赖未完成适配，或者应用签名配置错误，也会导致构建安装失败。
  检查android/app/build.gradle、AndroidManifest.xml等核心配置文件的语法是否正确，新增的原生依赖是否完成了Android端的配置要求。

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