Cordova Android项目构建失败：解决Unsupported class file major version 66错误

在开发Cordova Android应用时，开发者可能会遇到一个棘手的构建错误："Unsupported class file major version 66"。这个错误通常与Java版本不兼容有关，会阻碍项目的正常构建和发布流程。

错误原因分析

class文件主版本号66对应的是Java 22的字节码版本。当构建工具尝试处理由较新Java版本编译的类文件时，如果当前环境不支持该版本，就会抛出此错误。在Cordova Android项目中，这种情况通常由以下原因导致：

1. 系统中安装了多个Java版本，但环境变量配置不正确
2. 项目配置或构建脚本中指定了不兼容的Java版本
3. 构建工具链(Gradle、Android SDK等)版本与Java版本不匹配

解决方案

1. 检查并修正Java环境

首先确认当前实际使用的Java版本：

java -version

如果显示为Java 22或更高版本，需要降级到兼容版本。对于Cordova Android开发，推荐使用JDK 17，这是Android Studio默认支持并经过充分测试的版本。

2. 设置正确的环境变量

确保以下环境变量指向JDK 17的安装路径：

• JAVA_HOME：设置为JDK 17的根目录
• PATH：确保JAVA_HOME/bin位于其他Java版本路径之前

3. 项目级配置检查

在Cordova项目中，检查以下文件：

• build.gradle：确认没有强制指定不兼容的Java版本
• gradle-wrapper.properties：验证Gradle版本是否与JDK 17兼容

4. 清理并重建项目

执行以下命令清理可能存在的缓存问题：

cordova clean android
cordova platform remove android
cordova platform add android

最佳实践建议

1. 版本一致性：保持开发团队所有成员使用相同的JDK和工具链版本
2. 环境隔离：考虑使用工具如SDKMAN!或Docker来管理开发环境
3. 构建服务器配置：确保CI/CD环境与本地开发环境配置一致
4. 文档记录：在项目README中明确记录所需的开发环境版本

通过以上步骤，大多数情况下可以解决"Unsupported class file major version 66"错误，使Cordova Android项目恢复正常构建流程。