AndroidX Compose构建报错：类文件版本不兼容问题求助

你遇到的错误提示：

androidx/compose/compiler/plugins/kotlin/ComposeComponentRegistrar由更新版本的Java Runtime编译（类文件版本61.0），当前Java Runtime仅识别最高55.0版本的类文件

核心原因是：Gradle实际运行时使用的是JDK11（对应类文件版本55.0），但你的Compose库是基于JDK17（对应类文件版本61.0）编译的，导致版本不匹配。虽然你本地安装了JDK17，但Gradle并没有正确调用它。

排查与解决步骤 #

1. 检查Gradle的JVM配置 #

• 打开项目根目录的gradle.properties文件，确认是否配置了正确的JDK17路径：

  org.gradle.java.home=/path/to/your/jdk17
  

  替换为你本地JDK17的实际安装路径。
• 若使用Android Studio开发，检查IDE的Gradle JVM设置：
  依次进入File > Settings > Build, Execution, Deployment > Build Tools > Gradle，在Gradle JVM下拉菜单中选择已安装的JDK17。

2. 验证系统环境变量 #

• 在终端执行命令，确认JAVA_HOME指向JDK17：

  # Linux/macOS
  echo $JAVA_HOME
  # Windows
  echo %JAVA_HOME%
  

• 检查PATH环境变量，确保JDK17的bin目录优先级高于其他JDK版本，避免系统优先调用旧版本。

3. 刷新Gradle缓存并重新构建 #

执行以下命令清理缓存、强制刷新依赖后重新构建：

./gradlew clean build --refresh-dependencies

版本兼容性说明 #

你当前的环境组合（JDK17 + Compose 1.4.5 + Gradle 8.1 + Kotlin 1.8.20）完全符合官方兼容要求，不需要降级Compose或升级JDK到更高版本，只需确保Gradle正确使用JDK17运行即可。

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