必须让compileOptions和kotlinOptions的JVM目标版本完全一致且与JDK、Gradle、AGP兼容，常见有效组合是全部设为17；否则会导致字节码冲突、注解处理器失败或运行时异常。
直接结论：必须让 compileOptions 和 kotlinOptions 的 JVM 目标版本完全一致，且该版本需与你使用的 JDK、Gradle、AGP 兼容。常见有效组合是全部设为 17。
为什么 compileDebugJavaWithJavac 和 compileDebugKotlin 会报不一致？
这不是 IDE 显示错误，而是 Gradle 构建阶段真实发生的字节码冲突。Kotlin 编译器（kotlinc）生成的 class 文件，其 JVM 版本由 kotlinOptions.jvmTarget 控制；Java 编译器（javac）则由 compileOptions.targetCompatibility 决定。两者若不同（比如一个是 1.8，一个是 17），会导致：
- 运行时抛
IncompatibleClassChangeError或NoSuchMethodError（例如 Kotlin 调用了 Java 17 新增的String.isBlank()，但 Java 部分仍按 1.8 编译，没这个符号） - Kapt / KSP 注解处理器任务（如
kspDebugKotlin）直接失败，报Inconsistent JVM-target compatibility detected - CI 构建成功而本地失败——因为本地 IDE 可能缓存了旧的编译结果，掩盖了问题
怎么统一配置？关键四步不能漏
在模块级 build.gradle（通常是 app/build.gradle）的 android { } 块内，一次性配齐以下四项：
-
compileOptions必须显式声明：compileOptions { sourceCompatibility JavaVersion.VERSION_17 targetCompatibility JavaVersion.VERSION_17 } -
kotlinOptions必须显式声明（即使项目没写 Kotlin 代码，只要启用了 Kotlin 插件就得配）：kotlinOptions { jvmTarget = "17" } - 确保已启用 Kotlin Android 插件（不是旧的
kotlin-android，而是org.jetbrains.kotlin.android）：plugins { id 'org.jetbrains.kotlin.android' } - 如果用了 Kapt 或 KSP，它们会自动继承
kotlinOptions.jvmTarget，但要确认没有在kapt { }或ksp { }块里额外覆盖jvmTarget—— 这种覆盖会直接触发冲突
为什么改了还是报错？检查这三处硬性依赖
配置写对了，但构建仍失败，大概率是底层工具链没对齐：
立即学习“Java免费学习笔记（深入）”；
-
gradle-wrapper.properties中的distributionUrl必须匹配 JDK 17：例如https\://services.gradle.org/distributions/gradle-8.7-bin.zip（Gradle 8.x 支持 JDK 17–20） -
android { }外层的java { toolchain.version = "17" }（推荐放在build.gradle根部）比org.gradle.java.home更可靠，避免环境变量干扰 - Android Gradle Plugin（AGP）版本必须 ≥ 8.1：AGP 8.0+ 强制要求运行在 JDK 17 上，且默认将
kotlinOptions.jvmTarget设为"17"；如果你还在用 AGP 7.4，它默认只认"11"，强行设"17"会触发插件内部校验失败
多模块项目里部分模块报错，怎么办？
不要只改主模块。每个含 Java/Kotlin 源码的子模块，都必须单独配置 compileOptions 和 kotlinOptions。尤其注意：
- 库模块（
com.android.library）容易被忽略，但它输出的 AAR 也携带字节码版本信息，一旦和 app 模块不一致，合并 dex 时就会失败 - 如果某个模块纯 Java（没 Kotlin 插件），它不需要
kotlinOptions，但compileOptions仍得设成和其他模块一致的版本，否则跨模块调用时字节码不兼容 - 用
./gradlew :module-name:dependencies查看该模块实际解析出的 Kotlin 插件版本，确认没被某条传递依赖偷偷降级
最易被忽略的点：Kotlin 插件版本和 kotlin-stdlib 依赖版本必须严格对应。比如用了 org.jetbrains.kotlin.android:1.9.20，就必须配 implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk17:1.9.20" —— 少一个 jdk17 后缀，或版本号差一位，都可能在运行时因标准库 ABI 不匹配而崩溃。
