构建Ionic 4 Cordova Android项目时Gradle版本不兼容求助

我完全懂你这种明明按要求改了配置却还是踩坑的郁闷——明明装了Gradle 5.6.2，也改了wrapper配置，系统却死咬着4.10.3不放，太闹心了！下面几个步骤帮你排查解决：

1. 确认gradle-wrapper.properties的修改是否真的生效 #

先打开C:\Users\alan-\Desktop\Epacv1\gradle\wrapper\gradle-wrapper.properties，仔细检查distributionUrl这一行：

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

• 注意这里的\转义符不能丢，否则链接会失效
• 确保文件已经保存，没有被编辑器自动还原（有些编辑器会有“保存时恢复默认”的坑）

2. 清理Cordova平台缓存，重新生成Android平台 #

Cordova经常会缓存旧的配置文件，哪怕你改了wrapper，旧平台文件可能还在沿用老版本：

1. 先移除现有Android平台：

   ionic cordova platform rm android
   

2. 清理项目构建缓存：

   ionic cordova clean
   

3. 重新添加兼容Gradle 5.6.x的Android平台（建议选9.0.0版本，兼容性稳定）：

   ionic cordova platform add android@9.0.0
   

3. 检查系统环境变量的Gradle优先级 #

你虽然装了5.6.2，但如果系统PATH里旧版本的Gradle路径优先级更高，Cordova会优先调用系统Gradle而非wrapper：

1. 打开命令提示符，输入：

   gradle -v
   

   如果输出的是4.10.3，说明环境变量没配置对
2. 找到你安装Gradle 5.6.2的目录，把它的bin文件夹路径（比如D:\gradle-5.6.2\bin）添加到系统PATH的最顶端，确保它最先被识别
3. 重启命令提示符，再次输入gradle -v确认版本已经切换到5.6.2

4. 手动清理Gradle本地缓存 #

Gradle wrapper会把下载的Gradle包存在本地缓存，有时候旧包没被自动替换：

1. 找到Gradle缓存目录：C:\Users\alan-\.gradle\wrapper\dists
2. 找到里面名为gradle-4.10.3-all的文件夹，直接删除
3. 重新运行构建命令，让wrapper自动下载并使用5.6.1版本的Gradle包

5. 检查Android平台的Gradle插件版本 #

Android Gradle插件和Gradle版本是严格匹配的，如果插件版本不对，也会导致版本不兼容问题：
打开C:\Users\alan-\Desktop\Epacv1\platforms\android\build.gradle，找到dependencies里的classpath配置：

dependencies {
    classpath 'com.android.tools.build:gradle:3.5.3'
}

Gradle 5.6.x对应的Android插件版本是3.5.0~3.5.4，如果你的插件版本低于这个范围，改成3.5.3即可。

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