Quasar框架运行Cordova应用时Gradle构建失败如何解决？

问题背景 #

使用Quasar框架搭配Cordova构建Android应用时触发构建失败，核心错误信息如下：

FAILURE: 构建因异常失败。

• 出错原因：无法获取可变Windows环境变量映射

当前已配置的环境变量：

ANDROID_SDK_ROOT  C:\Users\myuser\AppData\Local\Android\Sdk
JAVA_HOME         C:\Program Files\Java\jdk-18.0.2.1
Path              C:\Gradle\gradle-4.10.3\bin; %ANDROID_SDK_ROOT%\tools;%ANDROID_SDK_ROOT%\platform-tools; C:\Program Files\Java\jdk-18.0.2.1\bin

解决方案 #

1. 修复JDK与Gradle版本兼容性 #

Gradle 4.10.3仅支持JDK 8~11版本，当前使用的JDK 18版本过高，存在兼容性冲突：

• 卸载JDK 18，重新安装JDK 8或JDK 11
• 更新JAVA_HOME环境变量指向新安装的JDK路径
• 更新Path中的JDK bin目录路径，替换为新JDK对应的bin目录

2. 修正环境变量配置 #

• 将Path中的%ANDROID_SDK_ROOT%替换为绝对路径，避免变量嵌套解析异常：

  Path              C:\Gradle\gradle-4.10.3\bin; C:\Users\myuser\AppData\Local\Android\Sdk\tools;C:\Users\myuser\AppData\Local\Android\Sdk\platform-tools; C:\Program Files\Java\jdk-xxx\bin
  

• 配置完成后重启命令行工具，执行java -version、gradle -v、adb version验证环境是否正常加载

3. 调整Cordova Android平台版本 #

Gradle 4.10.3适配Cordova Android 9.x版本，可重新添加兼容的平台：

# 移除现有Android平台
quasar cordova platform remove android
# 添加适配版本的Android平台
quasar cordova platform add android@9.0.0

4. 清理构建缓存 #

# 清理Quasar项目缓存
quasar clean
# 进入Cordova目录清理Android构建缓存
cd src-cordova
cordova clean android

5. 以管理员身份运行构建 #

Windows下权限不足可能导致环境变量读取失败，右键命令提示符/PowerShell选择「以管理员身份运行」，再执行构建命令：

quasar dev -m cordova -T android

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