M1 Mac运行Ionic Capacitor安卓项目Gradle构建失败JDK适配

不同版本Ionic Capacitor对JDK的版本要求有明确限制，版本不匹配是当前构建失败的核心原因：

• Capacitor 4及更低版本：仅兼容JDK 11，完全不支持JDK 17
• Capacitor 5及以上版本：兼容JDK 17，但要求Android Gradle Plugin版本≥8.0、Gradle版本≥8.0
• M1 Pro芯片设备必须使用arm64架构的JDK发行版，x86架构的JDK会触发隐性兼容问题
  碰到的模块java.base未向无名模块开放java.io权限报错，是JDK 17引入的强模块封装机制拦截了老版本Gradle插件的反射访问逻辑，直接导致:app:processDebugMainManifest任务执行失败。日志里的compile配置过时、flatDirs不推荐、jcenter即将停用提示都是非阻断警告，不是构建失败的根因。

方案一：切换到匹配版本JDK（稳定性最高，覆盖绝大多数场景） #

• 移除本地当前安装的OpenJDK 17，避免环境变量冲突，M1系列Mac的JDK默认安装路径为/Library/Java/JavaVirtualMachines/，直接删除对应版本的文件夹即可
• 优先使用Android Studio内置的arm64原生JDK 11：打开Android Studio，进入Settings > Build, Execution, Deployment > Build Tools > Gradle，在Gradle JDK下拉选项中选择内置的jbr-11（JetBrains Runtime 11），复制该JDK的本地路径
• 配置终端全局环境变量，zsh默认用户编辑~/.zshrc文件，添加以下配置：

export JAVA_HOME="刚才复制的内置JDK11路径"
export PATH="$JAVA_HOME/bin:$PATH"

• 执行source ~/.zshrc让配置即时生效，终端执行java -version，确认输出为JDK 11版本、架构标识为aarch64即配置正确
• 回到项目根目录执行以下命令清理缓存后重新构建：

rm -rf android/.gradle android/app/build node_modules/.cache
ionic cap sync android
ionic cap run android -l --external

方案二：保留JDK 17（仅适配Capacitor 5+项目） #

如果项目已经升级到Capacitor 5及以上版本，可以不用降级JDK，按以下步骤调整：

• 升级项目Capacitor依赖到最新稳定版，执行npm install @capacitor/cli@latest @capacitor/core@latest @capacitor/android@latest
• 用Android Studio打开项目下的android目录，等待Gradle同步提示，按引导将Android Gradle Plugin升级到8.0及以上版本、Gradle升级到8.0及以上版本
• 打开android/gradle.properties文件，在org.gradle.jvmargs配置项中添加JVM启动参数，放开模块访问限制：

org.gradle.jvmargs=-Xmx2048m --add-opens java.base/java.io=ALL-UNNAMED --add-opens java.base/java.lang=ALL-UNNAMED

• 同步Gradle配置后重新执行运行命令即可。

日志中的警告不影响当前构建调试，后续可按需处理：

• compile配置过时警告：将android/app/build.gradle中依赖声明的compile关键字替换为implementation即可
• flatDirs不推荐警告：后续可将本地aar依赖从flatDirs引用迁移为本地maven仓或源码依赖
• jcenter即将停用警告：将android/build.gradle中repositories块内的jcenter()移除，替换为mavenCentral()即可

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