AndroidStudio编译报错`General error during conversion: Unsupported class file major version 61`

最新推荐文章于 2025-10-25 23:59:30 发布
原创 最新推荐文章于 2025-10-25 23:59:30 发布 · 1.1w 阅读 · 11 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#android #android-studio

升级Android Studio后遇到运行错误，原因是Java编译器版本过高（JavaVersion.VERSION_17）与工程所需的JavaVersion.VERSION_1_8不匹配。通过修改JDK配置为正确版本（JavaVersion.VERSION_1_8），重新编译后，成功解决工程运行问题。

最近升级了一下android studio，发现运行工程报错General error during conversion: Unsupported class file major version 61

image.png

错误的原因是：Java 编译器 版本和Android sdk版本不匹配
看了一下自己的电脑JDK版本，居然是JavaVersion.VERSION_17，而工程build.gradle文件中是要求JavaVersion.VERSION_1_8，那就是自己JDK版本太高导致
image.png
点击gradle Settings，进入JDK配置页面
image.png
配置正确的JDK版本，重新编译工程，正常运行。

大数据编译报错：不支持的类文件主要版本
2301_79367634的博客
08-26 1084
当我们编写代码并使用编译器将其转换为可执行的字节码时，编译器会根据所使用的 JDK 版本来决定生成的字节码的版本。每个 JDK 版本都有对应的字节码主要版本，例如 Java 8 对应的主要版本是 52，Java 11 对应的主要版本是 55。如果我们的代码使用了较新的 JDK 特性或库，我们可以将 JDK 或 JRE 版本升级到与代码生成的字节码版本兼容的版本。如果我们无法修改源代码或升级 JDK 版本，我们可以使用字节码转换工具来将生成的字节码文件转换为较旧的主要版本。
General error during semantic analysis: Unsupported class file major version 61
菜鸟博客
04-09 2425
General error during semantic analysis: Unsupported class file major version 61
【异常】jdk21升级，asm报错Unsupported class file major version 65 springboot2 升级JDK21
我是Superman丶的博客
12-19 8334
【异常】jdk21升级，asm报错Unsupported class file major version 65。升级spring-core版本，整体springboot升级。在代码里写死了限制jdk版本。排查 发现是这个类导致的。
Unsupported class file major version 61
最新发布
qq_16099225的博客
10-25 247
摘要：JDK版本不兼容是导致"Unsupported class file major version 61"错误的主要原因。解决方案是降低JDK版本（如从17降为8），并检查修改两个相关配置文件的JDK设置。该问题通常出现在高版本JDK编译的程序在低版本环境中运行时。
android studio apt代码编写实战
SunShanai的博客
05-06 509
之所以试一下apt代码的编写，是因为发现几年前写的工程，在新的android studio中debug apt代码时，一直连不上debug环境，提示报错解决了两天，未果，推测大概率环境问题，google了一下，发现很多android studio的apt文章都是3~5年前的老工程，于是重新建工程，从头到尾试一下。
Android （已解决）Gradle 编译失败 Unsupported class file major version 61
热门推荐
一碗清深的博客
06-28 1万+
确认选中了当前项目(即不同项目可以使用不同的 JDK 版本)，根据实际情况，在 Gradle JDK 中设置一个 jdk 11 或者 8 的版本，如果没有，可以选择 Dowload 下载一个对应版本。操作方法：File - Settings - Build, Execution, Deployment - Build Tools - Gradle。新版本的 Android Studio 默认使用的是 Java 17 LTS，而这个历史项目的 Gradle 版本很低，不支持高版本的 Java。
开发Android原生插件，引入自己打的jar报，编译报 Unsupported class file major version 61
weixin_45442111的博客
06-30 1万+
Unsupported class file major version 61” 错误的原因是由于你自己大的jar包当时是用的Java 17打包的，因为在 Java 中，每个主要版本都有一个对应的 major version 值。例如，Java 8 的 major version 值为 52，Java 9 的 major version 值为 53，以此类推。Java 17 的 major version 值为 61。
Android Studio Error “Unsupported class file major version 61“---异常信息记录
dodod2012的专栏
01-11 3796
Unsupported class file major version 61
General error during conversion: Unsupported class file major version 65
05-22
### 关于 'Unsupported class file major version 65' 错误的解决方案 `java.lang.UnsupportedClassVersionError: Unsupported class file major version 65` 是一种常见的 Java 运行时错误，表明当前运行环境中的 ...
flutter General error during conversion: Unsupported class file major version 66
05-26
如果您正在使用Android Studio开发Flutter应用程序，请确保Android Studio使用的Java版本是8或更高版本。您可以在File -> Project Structure -> SDK Location中找到您当前使用的Java版本，并确保它是8或更高版本。
startup failed: General error during conversion: Unsupported class file major version 61
08-30
这个错误是由于你尝试运行一个使用了不受支持的 Java 类文件版本的程序导致的。根据错误消息，你使用的类文件的主要版本为 61，而你当前的 Java 运行环境不支持该版本。 要解决这个问题，你需要更新你的 Java 运行...
AndroidStudio工程apg升级8.9.1， jdk17后编译出现startup failed: General error during conversion: Unsupported class file major version 61 java.lang.IllegalArgumentException: Unsupported class file major version 61 at groovyjarjarasm.asm.ClassReader.<init>(ClassReader.java:189) at groovyjarjarasm.asm.ClassReader.<init>(ClassReader.java:170) at groovyjarjarasm.asm.ClassReader.<init>(ClassReader.java:156) at groovyjarjarasm.asm.ClassReader.<init>(ClassReader.java:277)
08-05
我们正在解决一个Android Studio项目升级问题：将AGP(Android Gradle Plugin)升级到8.9.1并使用JDK 17编译时，出现错误“Unsupported class file major version 61”。这个错误通常是因为编译环境使用的Java版本与...
报错：Unsupported class file major version 61
weixin_46197296的博客
01-12 5899
解决思路： 大概是JDK和Spring版本不对应。
Unsupported class file major version 61 error in Java
张三的博客
01-26 1647
4、查看插件内部引用的插件是否兼容。2、更改本地环境java环境变量。3、查看本地插件的版本是否兼容。1、更改IDE 的jdk版本。
（笔记）Android Studio “Unsupported class file major version 61“ .
u011046452的博客
04-28 279
JDK版本过高了降低到8或者11。
General error during conversion: Unsupported class file major version 61
06-07
<think>我们遇到了两个核心问题：1.SDKXML版本不兼容：当前工具仅支持到版本3，但遇到了版本4的文件2.Unsupportedclassfilemajorversion61：表明正在尝试使用Java17编译的类文件，但当前运行环境是低版本Java（如Java8）这两个问题通常发生在Android开发环境中，由以下原因引起：-使用了较新的AndroidStudio（自带较高版本的Java，如JDK17）与旧版本命令行工具（如旧版Gradle或旧版JDK）混合-项目配置的Java版本与运行环境不匹配解决思路：1.统一Java版本：确保整个项目使用一致的Java版本（建议使用AndroidStudio自带或项目指定的JDK）2.更新构建工具：确保Gradle、AndroidGradle插件与Java版本兼容3.检查SDK工具版本：确保命令行工具与AndroidStudio版本兼容具体解决步骤：###步骤1：解决"Unsupportedclassfilemajorversion61"（Java版本不匹配）这个错误表明你正在尝试用较旧版本的Java运行一个由较新版本Java编译的类文件。Java版本与类文件版本对应关系：-Java8→majorversion52-Java9→majorversion53-Java10→54-Java11→55-Java12→56-Java13→57-Java14→58-Java15→59-Java16→60-Java17→61因此，majorversion61对应Java17。解决方法：1.**检查并设置项目的JDK版本**-在AndroidStudio中，打开`File>ProjectStructure`，在`SDKLocation`选项卡中设置JDK路径（使用AndroidStudio自带的JDK，通常为`jbr`目录）[^1]。-在`ProjectStructure`的`Project`选项卡中，设置`ProjectSDK`和`Projectlanguagelevel`为与目标版本一致（例如JDK17）。2.**配置Gradle使用的JDK版本**-在AndroidStudio中，打开`File>Settings>Build,Execution,Deployment>BuildTools>Gradle`-在`GradleJDK`下拉框中选择与项目兼容的JDK版本（如果项目需要Java17，则选择Java17）。3.**确保模块的Java版本**-在模块的`build.gradle`文件中，设置`compileOptions`：```groovyandroid{compileOptions{sourceCompatibilityJavaVersion.VERSION_17targetCompatibilityJavaVersion.VERSION_17}}```4.**验证环境变量**-检查系统环境变量`JAVA_HOME`是否指向正确的Java版本（应与AndroidStudio使用的版本一致）。可以通过终端运行：```bashecho$JAVA_HOME#macOS/Linuxecho%JAVA_HOME%#Windows```-如果系统环境变量指向旧版本Java，更新为指向JDK17（AndroidStudio自带JDK通常位于：`/Applications/AndroidStudio.app/Contents/jbr/Contents/Home`（macOS）或`C:\ProgramFiles\Android\AndroidStudio\jbr`（Windows））。###步骤2：解决SDKXML版本不兼容问题错误信息表明命令行工具版本过旧，不支持新的SDKXML格式（版本4）。解决方法：1.**更新AndroidSDK命令行工具**-打开AndroidStudio，进入`Tools>SDKManager`。-选择`SDKTools`选项卡。-勾选`AndroidSDKCommand-lineTools(latest)`，然后点击`Apply`。这将安装最新的命令行工具，支持XML版本4。2.**验证命令行工具路径**-确保系统环境变量`PATH`中指向的是新安装的命令行工具。安装后，命令行工具通常位于：-macOS/Linux:`~/Library/Android/sdk/cmdline-tools/latest/bin`-Windows:`%LOCALAPPDATA%\Android\Sdk\cmdline-tools\latest\bin`-在终端中运行`sdkmanager--version`确认版本（如果提示命令未找到，说明路径未正确配置）。3.**检查项目配置**-确保项目目录中`local.properties`文件中的`sdk.dir`指向正确的SDK路径。该文件应类似：```sdk.dir=/Users/username/Library/Android/sdk```###步骤3：同步Gradle和AndroidGradle插件版本为了避免兼容性问题，需要确保：-AndroidGradle插件版本与Gradle版本兼容-它们都支持Java171.**检查并更新AndroidGradle插件版本**-在项目级的`build.gradle`文件中，检查`dependencies`块中的插件版本：```groovydependencies{classpath'com.android.tools.build:gradle:8.2.0'//确保使用较新版本（支持Java17）}```-参考官方兼容性表[^1]：AndroidGradle插件8.x需要Java17，并兼容Gradle8.x。2.**更新GradleWrapper**-在项目根目录的`gradle/wrapper/gradle-wrapper.properties`文件中，设置Gradle版本与插件兼容：```propertiesdistributionUrl=https\://services.gradle.org/distributions/gradle-8.4-bin.zip```###步骤4：清理并重建项目完成以上配置后：1.在AndroidStudio中执行`File>InvalidateCaches/Restart`（选择`InvalidateandRestart`）。2.同步项目：点击`SyncProjectwithGradleFiles`按钮。3.尝试重新构建项目。###其他提示-如果问题持续，考虑删除项目中的`.gradle`和`.idea`目录，然后重新导入项目。-对于多模块项目，确保所有模块使用一致的Java版本和AndroidGradle插件版本。###相关问题1.如何在命令行中手动安装AndroidSDK命令行工具？2.如何降级Java版本以兼容旧项目？3.AndroidGradle插件与Gradle版本的对应关系是什么？4.如何解决Gradle构建过程中的依赖冲突？5.Android项目中如何配置多环境构建？通过以上步骤，应该能解决SDKXML版本不兼容和Java版本不匹配问题。如果仍有特定问题，请提供详细的错误日志或配置信息以便进一步分析。</think> ### 解决方案：Android Studio 版本不兼容问题 您遇到的 "SDK XML version 4 not supported" 和 "Unsupported class file major version 61" 是典型的 Java 版本与 SDK 工具链不兼容问题。根本原因是 Android Studio、JDK 和 Gradle 组件的版本冲突。以下是系统性的解决方法： --- ### 一、问题定位与核心原理 1. **SDK XML version 4** - ✅ 错误本质：Android Studio 的 SDK 管理器使用 XML 配置 SDK 组件 - 🚨 版本冲突：旧版 SDK 命令行工具（如 v3）无法解析新版 XML 格式（v4） - 📌 触发条件：使用新版 Android Studio + 旧版命令行工具混合编译项目 2. **Unsupported class file major version 61** - ✅ 错误本质：Java 字节码版本不兼容 - 🔢 版本对照： ``` Java 17 → major version 61 Java 11 → major version 55 Java 8 → major version 52 ``` - 📌 触发条件：项目用 Java 17 编译 → Gradle/JDK 用 Java 11 或更低运行 --- ### 二、彻底解决步骤 #### ▶ 步骤 1：统一 JDK 版本（解决 major version 61） ```bash # 检查当前 JDK 版本 $ java -version # 推荐配置（选其一）： # 方案A：项目降级至 Java 11（兼容性更好） # 方案B：开发环境升级至 Java 17 ``` 1. **Android Studio 配置** - `File > Project Structure > SDK Location`: - 修改 **JDK Location** → 指向目标版本 JDK（建议 Java 11 或 17） ![SDK Location](https://developer.android.com/static/studio/images/project-structure-sdk-location_2x.png) - `Project Structure > Modules > Source Compatibility`: - 设置与 JDK Location **相同的 Java 版本** 2. **Gradle 配置**（关键！） 在 `build.gradle` 添加： ```groovy android { compileOptions { sourceCompatibility JavaVersion.VERSION_11 // 统一为 Java 11 targetCompatibility JavaVersion.VERSION_11 } } ``` #### ▶ 步骤 2：修复 SDK 命令行工具（解决 XML v4） ```bash # 删除冲突的旧版工具 $ rm -rf $ANDROID_HOME/cmdline-tools/* # Windows: del /s %ANDROID_HOME%\cmdline-tools\* ``` 1. **重新安装匹配的工具** - Android Studio → `Tools > SDK Manager > SDK Tools` - ✅ 勾选 **Android SDK Command-line Tools (latest)** - ❌ 取消旧版工具（如版本 3.x） - **强制生效**：重启 Android Studio 后执行 `File > Sync Project with Gradle Files` #### ▶ 步骤 3：升级构建环境（预防性措施） | 组件 | 要求版本 | 验证命令 | |------|----------|-----------| | Gradle | ≥ 7.3 (支持 Java 17) | `./gradlew -v` | | Android Gradle Plugin | ≥ 7.0 (兼容 SDK v4) | `build.gradle` 的 `classpath` 项 | | Android SDK Build-Tools | ≥ 30.0.3 | SDK Manager → `SDK Tools` | 在 `gradle-wrapper.properties` 确认： ```properties distributionUrl=https\://services.gradle.org/distributions/gradle-7.6-bin.zip ``` #### ▶ 步骤 4：清理残留冲突 1. 删除项目目录下的 **.gradle** 和 **build** 文件夹 2. 执行缓存清理: `File > Invalidate Caches / Restart → Invalidate and Restart` 3. 检查环境变量： - `JAVA_HOME` 指向正确版本 - `PATH` 优先包含 Android Studio 的 JDK（非系统 JDK） --- ### 三、兼容性配置参考 | 问题组件 | 推荐版本 | 作用 | |---------|----------|------| | JDK | 11 (LTS) | 平衡兼容性与新特性 | | Android SDK Command-line Tools | 8.0+ | 原生支持 XML v4 | | Gradle | 7.3~8.2 | 兼容 Java 11/17 | | Android Gradle Plugin | 7.2.0+ | 修复 SDK 解析逻辑[^1] | > 💡 **最佳实践**：使用 Android Studio 自带的 JDK（路径示例） > - macOS: `/Applications/Android Studio.app/Contents/jbr/Contents/Home` > - Windows: `C:\Program Files\Android\Android Studio\jbr` --- ### 相关问题 1. 如何查看 Android Gradle 插件与 Gradle 版本的兼容性？ 2. 多 JDK 环境下如何指定 Android Studio 使用的 Java 版本？ 3. 升级 Java 17 后哪些 Android 特性会受限？ 4. 如何彻底卸载冲突的 Android SDK 组件？ 5. Android Studio 有哪些强制刷新项目缓存的机制？
评论 2
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

itbird01

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值