使用PhoneGap/Cordova构建Android应用失败求助

我之前也碰到过一模一样的问题，核心原因基本是Gradle与Groovy版本不兼容、本地Gradle缓存损坏，或者系统全局环境干扰了项目构建。先把你遇到的错误日志贴出来方便对照：

错误日志详情 #

执行的构建命令：

cordova build android

输出结果：

检测到Android Studio项目
ANDROID_HOME=/home/harish/Android/Sdk
JAVA_HOME=/usr/lib/jvm/java-8-openjdk-amd64
studio
FAILURE: 构建因异常失败。
错误原因：
无法初始化类org.codehaus.groovy.runtime.InvokerHelper
建议操作：
使用--stacktrace选项获取堆栈跟踪信息。
使用--info或--debug选项获取更多日志输出。
使用--scan选项获取完整分析信息。
构建在0秒内失败
(node:26252) UnhandledPromiseRejectionWarning: 未处理的Promise拒绝（拒绝ID：1）：错误：/usr/lib/gradle/4.4.1/bin/gradle：命令执行失败，退出码为1
(node:26252) [DEP0018] DeprecationWarning: 未处理的Promise拒绝已被弃用。未来，未处理的Promise拒绝将以非零退出码终止Node.js进程。

下面是几个亲测有效的解决办法，你可以按顺序试试：

1. 改用项目自带的Gradle Wrapper #

系统全局安装的Gradle（比如你用的4.4.1）很可能和Cordova项目要求的版本不匹配，用项目自带的Wrapper能隔离环境冲突：

• 进入项目的platforms/android目录
• 找到gradle/wrapper/gradle-wrapper.properties文件，修改distributionUrl为Java 8兼容的Gradle版本（比如6.7.1，这是Java 8支持的最高稳定Gradle版本）：

  distributionUrl=https\://services.gradle.org/distributions/gradle-6.7.1-all.zip
  

• 回到项目根目录，先执行cordova clean android清理旧构建文件，再重新运行cordova build android，这时候会自动下载对应版本的Gradle，不用管全局环境

2. 清理Gradle缓存 #

缓存损坏也是常见诱因，清空缓存后重新构建就能解决：

• 关闭所有相关终端和IDE
• 删除~/.gradle/caches目录下的所有内容（Linux/macOS路径，Windows是C:\Users\<你的用户名>\.gradle\caches）
• 重新执行构建命令，让Gradle重新生成干净的缓存

3. 排查全局Groovy环境干扰 #

如果你的系统安装了全局Groovy，它可能会和Gradle自带的Groovy版本冲突：

• 临时移除系统Groovy的环境变量（比如从PATH里删掉Groovy的安装路径）
• 打开新的终端窗口，重新执行cordova build android
• 如果问题解决了，后续可以考虑调整环境变量优先级，或者一直用Gradle Wrapper来避免冲突

4. 验证Cordova依赖完整性 #

最后检查一下Android相关依赖是否齐全：

• 执行cordova requirements android命令，查看有没有缺失的组件（比如Android SDK Build Tools、Target SDK版本等）
• 按照提示安装对应的缺失组件，确保依赖满足Cordova的要求

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