笔记APP打包APK遇kaptGenerateStubsDebugKotlin JVM版本兼容错误求助

我开发完一款笔记APP，打包生成APK时遇到错误：任务:app:kaptGenerateStubsDebugKotlin执行失败。提示compileDebugJavaWithJavac任务（当前目标版本1.8）与kaptGenerateStubsDebugKotlin任务（当前目标版本17）的JVM目标兼容性需设置为同一Java版本，建议使用JVM工具链。尝试将Java版本从17改为20后又出现其他错误，以下是我的build.gradle.kts代码：

plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("kotlin-kapt")
}

android {
    namespace = "ir.hmoda7y.notes"
    compileSdk = 33

    defaultConfig {
        applicationId = "ir.hmoda7y.notes"
        minSdk = 28
        targetSdk = 33
        versionCode = 1
        versionName = "1.0"

        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(
                getDefaultProguardFile("proguard-android-optimize.txt"),
                "proguard-rules.pro"
            )
        }
    }

    buildFeatures{
        viewBinding = true
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

dependencies {
    implementation("com.android.car.ui:car-ui-lib:2.5.1")
    val room_version = "2.5.2"
    implementation("androidx.room:room-runtime:$room_version")
    annotationProcessor("androidx.room:room-compiler:$room_version")

    kapt("androidx.room:room-compiler:$room_version")

    implementation("androidx.room:room-ktx:$room_version")


    implementation ("androidx.lifecycle:lifecycle-viewmodel-ktx:2.4.1")
    implementation ("androidx.lifecycle:lifecycle-runtime-ktx:2.4.1")
    implementation ("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.3.9")

    implementation("androidx.core:core-ktx:1.9.0")
    implementation("androidx.appcompat:appcompat:1.6.1")
    implementation("com.google.android.material:material:1.9.0")
    implementation("androidx.constraintlayout:constraintlayout:2.1.4")
    testImplementation("junit:junit:4.13.2")
    androidTestImplementation("androidx.test.ext:junit:1.1.5")
    androidTestImplementation("androidx.test.espresso:espresso-core:3.5.1")
}

问题原因 #

项目中Java编译目标版本（1.8）和KAPT使用的JVM版本不匹配，尽管在kotlinOptions里设置了jvmTarget = "1.8"，但KAPT未继承该配置，或者本地环境默认JDK版本为17导致冲突。此外，重复的Room编译器依赖和部分过时依赖也可能引发额外问题。

修复步骤 #

1. 统一JVM目标版本并启用工具链 #

在android块中添加JVM工具链配置，指定统一的Java 17版本（Android Studio默认推荐版本，兼容性更佳）：

android {
    // ... 保留原有其他配置
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = "17"
    }
    // 添加JVM工具链配置
    kotlin {
        jvmToolchain(17)
    }
}

2. 移除重复依赖 #

同时使用annotationProcessor和kapt引入Room编译器会导致冲突，保留kapt即可（适配Kotlin项目）：

dependencies {
    // ... 其他依赖
    val room_version = "2.5.2"
    implementation("androidx.room:room-runtime:$room_version")
    // 移除该行：annotationProcessor("androidx.room:room-compiler:$room_version")
    kapt("androidx.room:room-compiler:$room_version")
    implementation("androidx.room:room-ktx:$room_version")
    // ... 其他依赖
}

3. 更新过时依赖 #

将部分版本较旧的依赖更新至兼容版本，避免潜在冲突：

implementation ("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3")
implementation ("androidx.lifecycle:lifecycle-viewmodel-ktx:2.6.2")
implementation ("androidx.lifecycle:lifecycle-runtime-ktx:2.6.2")

4. 清理重建项目 #

执行以下操作确保配置生效：

• 点击Android Studio菜单栏Build -> Clean Project
• 然后选择Build -> Rebuild Project
• 最后重新尝试打包APK

内容的提问来源于stack exchange，提问作者7moda7y the best