从Windows转Linux后运行Ionic 3项目报错求助：UnhandledPromiseRejectionWarning

我之前跨系统迁移Cordova项目时也碰到过类似的坑，给你几个实用的排查和解决方向：

• 统一Node.js与npm版本
  Windows和Linux的Node/npm版本差异很可能是诱因，Cordova对Node版本兼容性要求比较严格。先在两边分别运行node -v和npm -v确认版本是否一致，Linux上可以用nvm快速切换到匹配的版本。之后删掉项目根目录的node_modules文件夹和package-lock.json，重新执行npm install，确保依赖是适配Linux环境的。

• 彻底清理Cordova缓存与构建文件
  跨系统后遗留的Windows构建缓存很可能导致兼容性问题，执行以下命令彻底清理重建：

  ionic cordova clean android
  rm -rf platforms/android
  rm -rf plugins
  npm install
  ionic cordova prepare android
  

  注意Linux下删除目录用rm -rf，别和Windows的命令混淆。

• 检查Android SDK环境变量配置
  Linux下的Android SDK环境变量配置逻辑和Windows不同，务必确认ANDROID_SDK_ROOT（或旧版的ANDROID_HOME）已正确设置，且$ANDROID_SDK_ROOT/tools、$ANDROID_SDK_ROOT/platform-tools已加入系统PATH。可以通过echo $ANDROID_SDK_ROOT和echo $PATH验证，同时用adb devices确认ADB能正常识别设备。

• 排查插件兼容性问题
  部分Cordova插件可能因文件权限、编译依赖等问题在Linux下出错。可以尝试先移除所有非核心插件，运行ionic cordova run android测试，如果恢复正常，再逐个重新添加插件并测试，定位出问题的插件后，查看其是否有Linux适配的更新版本。

• 获取详细错误日志定位问题
  执行命令时加上--verbose参数，输出更详细的构建日志：

  ionic cordova run android --verbose
  

  从日志里可以找到具体抛出错误的模块或步骤，能更精准地定位问题根源。

内容的提问来源于stack exchange，提问作者Rishi.S