android java.lang.IllegalArgumentException: Unsupported class file major version 61

解析 java.lang.IllegalArgumentException: Unsupported class file major version 61 错误
当遇到 java.lang.IllegalArgumentException: Unsupported class file major version 61 的错误时，这通常意味着编译后的 Java 类文件版本与当前环境中的 JVM 或其他工具链组件所支持的最高版本不符。具体而言，major version 61 对应于 Java 17。
可能的原因

使用了较新的 JDK 版本来编译代码，而构建工具或运行时环境配置仍停留在旧版。
Android Gradle 插件或其他依赖项未能正确识别并兼容新版本的 Java 字节码格式[^1]。

解决方案
为了修复此问题，可以采取以下措施：
调整项目设置以匹配合适的JDK版本
如果项目的最低 SDK 支持级别允许，则考虑升级整个项目的 JDK 配置到至少 Java 17 (即 Major Version 61)，从而确保所有模块都一致地使用相同级别的字节码标准。对于 Android Studio 用户来说，在 File -> Project Structure... 中调整 "Project" 和 "Modules" 下的相关选项即可实现这一点。
// build.gradle 文件内指定Java版本
compileOptions {
sourceCompatibility JavaVersion.VERSION_17
targetCompatibility JavaVersion.VERSION_17
}
登录后复制
更新Gradle插件及其他依赖库至最新稳定版
确保使用的 Android Gradle Plugin 是最新的，并且与其他必要的第三方库保持同步更新状态。有时这些工具本身也会存在对特定 Java 版本的支持限制，因此及时跟进官方发布的改进非常重要。
plugins {
id 'com.android.application' version '8.0.0' apply false // 假设这是适用于Java 17的第一个AGP版本
}
登录后复制
修改编译器参数适应更低级的目标平台
如果不希望立即迁移到更高版本的 Java 运行时环境中去，也可以通过修改编译指令让其生成更广泛的向下兼容性的 .class 文件。不过需要注意这样做可能会丧失部分现代语言特性和性能优化特性。
javac -source 1.8 -target 1.8 YourSourceCode.java
登录后复制
以上方法应该能够帮助缓解由于不同版本间差异引发的一系列兼容性挑战。当然，最佳实践还是尽可能使开发流程中涉及的各项技术栈维持在一个相对统一的基础之上，以便减少不必要的麻烦。