1. 问题现象与初步诊断
当尝试使用cordova构建android应用时，如果遇到以下类似的错误信息，表明您可能正面临java版本兼容性问题：
-
cordova requirements 命令输出错误：
Command failed with exit code 1: avdmanager list target Exception in thread "main" java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlSchema at com.android.repository.api.SchemaModule$SchemaModuleVersion.(SchemaModule.java:156) ... Caused by: java.lang.ClassNotFoundException: javax.xml.bind.annotation.XmlSchema at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:641) ... 此错误通常指示Android SDK工具在运行时无法找到 javax.xml.bind.annotation.XmlSchema 类。这个类属于JAXB (Java Architecture for XML Binding) 模块，在Java 9及更高版本中被移除，导致旧版Android SDK工具链无法正常工作。
-
cordova build 命令输出错误：
FAILURE: Build failed with an exception. * What went wrong: Could not compile settings file 'C:\Users\NAME\Desktop\TestProject\platforms\android\settings.gradle'. > startup failed: General error during semantic analysis: Unsupported class file major version 63
Unsupported class file major version 63 错误是Java编译环境中常见的兼容性问题。它表示Gradle尝试使用一个旧版本的Java编译器（或运行时）来处理由一个新版本Java（本例中为Java 19）编译生成的类文件。Java 19对应的Major Version是63，而Gradle或其依赖的某些组件可能只支持到Java 11（Major Version 55）或Java 8（Major Version 52）。
立即学习“Java免费学习笔记（深入）”；
在上述问题场景中，开发者使用的环境配置为：
- Java Version: 19.0.1
- Cordova Version: 11.0.0
- NPM Version: 7.15.0
- Gradle Version: 6.9.3
2. 根本原因分析
这些错误的核心在于Java JDK版本与Cordova、Android SDK工具及Gradle版本之间的兼容性不匹配。
Unsupported class file major version 63： Cordova 11.0.0及其Android平台插件，以及其内部使用的Gradle版本（即使是6.9.3），可能并未完全兼容Java 19。通常，Cordova的Android平台构建系统在发布时会针对特定的Java LTS（长期支持）版本进行优化和测试，例如Java 8或Java 11。使用高于推荐版本的Java JDK会导致Gradle在尝试编译或执行某些任务时，无法识别由新版本Java生成的类文件格式。
NoClassDefFoundError: javax/xml/bind/annotation/XmlSchema： 如前所述，JAXB模块在Java 9中被标记为弃用，并在Java 11中从JDK中移除。Android SDK的某些旧工具（如avdmanager）可能仍然依赖这些模块。当使用Java 11或更低版本时，这些模块是内置的或可以通过模块化配置引入；但在Java 19中，它们完全缺失，导致运行时错误。
综合来看，Java 19对于Cordova 11.0.0和其依赖的Android构建工具链来说，版本过高，导致了上述一系列兼容性问题。
3. 解决方案：降级Java JDK至版本11
解决此问题的最直接且有效的方法是降级您系统中的Java JDK版本至Java 11。Java 11是一个LTS版本，与Cordova 11.0.0和Gradle 6.9.3具有良好的兼容性。
3.1 步骤一：卸载或禁用当前Java 19
首先，您需要确保系统不再默认使用Java 19。您可以选择卸载Java 19，或者如果您需要保留多个Java版本，则需要配置您的环境，使其指向Java 11。
3.2 步骤二：安装Java Development Kit (JDK) 11
从Oracle官网或其他OpenJDK发行版（如Adoptium/Eclipse Temurin）下载并安装Java 11 LTS版本。
- 下载链接示例 (Adoptium): https://www.php.cn/link/bd082db9d2511ac2195e984d6eee33b8 选择适用于您操作系统的JDK 11版本进行下载和安装。
3.3 步骤三：配置环境变量
安装Java 11后，您需要更新系统的环境变量，确保 JAVA_HOME 指向新安装的Java 11路径，并将其添加到 PATH 变量中。
Windows 系统配置：
- 打开“系统属性” -> “高级” -> “环境变量”。
- 在“系统变量”中，查找或新建 JAVA_HOME 变量，将其值设置为您的Java 11安装路径（例如：C:\Program Files\Java\jdk-11.0.x）。
- 在“系统变量”中，找到 Path 变量，编辑它，添加 %JAVA_HOME%\bin。确保它在其他可能指向旧Java版本的路径之前。
- 如果存在 ANDROID_HOME 变量，虽然已被弃用，但为了兼容性，可以检查其是否指向正确的Android SDK路径（例如：C:\Users\NAME\AppData\Local\Android\Sdk）。推荐使用 ANDROID_SDK_ROOT 变量指向此路径。
macOS/Linux 系统配置：
- 打开终端。
- 编辑您的 shell 配置文件（例如 ~/.bash_profile, ~/.zshrc, ~/.profile）。
- 添加或修改以下行，将 /path/to/jdk-11 替换为您的Java 11安装路径：
export JAVA_HOME=/Library/Java/JavaVirtualMachines/jdk-11.0.x.jdk/Contents/Home # macOS示例 # 或者 # export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64 # Linux示例 export PATH="$JAVA_HOME/bin:$PATH"
- 保存文件并执行 source ~/.bash_profile (或对应您的配置文件) 使更改生效。
3.4 步骤四：验证Java版本
在命令行中执行以下命令，确认系统正在使用Java 11：
java -version
输出应显示Java 11版本信息，例如：
openjdk version "11.0.x" 202x-xx-xx OpenJDK Runtime Environment (build 11.0.x+x) OpenJDK 64-Bit Server VM (build 11.0.x+x, mixed mode)
3.5 步骤五：重新运行Cordova检查和构建命令
-
清理项目： 在项目根目录下执行清理命令，以确保所有旧的构建文件被移除。
cordova clean android
-
检查环境要求： 再次运行 cordova requirements 命令，确认所有依赖项都已正确配置。
cordova requirements
此时，您应该看到 Android target: installed 并且不再出现 NoClassDefFoundError。
-
构建项目： 最后，尝试重新构建您的Cordova Android项目。
cordova build android
构建过程应该能够顺利完成，不再出现 Unsupported class file major version 63 错误。
4. 注意事项与最佳实践
- 版本兼容性： 始终查阅Cordova官方文档，了解其Android平台插件推荐的Java JDK、Gradle和Android SDK版本。不同版本的Cordova可能对这些工具有不同的兼容性要求。
-
多JDK管理： 如果您需要在同一台机器上使用多个Java版本进行不同项目开发，可以考虑使用Java版本管理工具，例如：
- SDKMAN! (Linux/macOS): curl -s "https://get.sdkman.io" | bash，然后 sdk install java 11.0.x-tem。
- JEnv (macOS/Linux): 允许您在不同项目目录中切换Java版本。
- 手动切换： 通过修改 JAVA_HOME 环境变量来手动切换。
- Android SDK更新： 确保您的Android SDK Manager中的工具（SDK Tools, Platform Tools, Build Tools）都是最新或推荐版本。
- Gradle缓存： 有时，Gradle的旧缓存可能导致问题。在极端情况下，可以尝试清理Gradle缓存目录（通常在用户主目录下的 .gradle 文件夹）。
5. 总结
“Unsupported class file major version 63”和“NoClassDefFoundError”是Cordova Android开发中常见的Java版本兼容性问题。通过将Java JDK从Java 19降级到Java 11，并正确配置环境变量，可以有效解决这些构建错误。理解不同开发工具链之间的版本兼容性是确保项目顺利构建和运行的关键。在开始新项目或升级开发环境时，务必参考官方文档，以避免此类问题。
