Kotlin调用JEP 434 FFM API遇版本兼容问题，求解决方案

问题描述 #

我想在Kotlin中调用通过jextract生成的基于FFM的C库Java API，但遇到了JVM版本兼容问题：

• 当Java编译目标设为20，Kotlin目标设为19时，Gradle报错两者版本不一致
• 把Java目标改为19时，出现Unresolved reference: Arena错误（找不到FFM核心类）
• 尝试将Kotlin目标设为20时，Kotlin提示Unknown Kotlin JVM target: 20

原本以为可以用Java 19语言级别编译，在Java 20环境运行FFM，但实践失败，想知道是否必须等Kotlin支持Java 20字节码，以及是否有可行的变通方案。

当前Gradle配置如下：

tasks {
    val ENABLE_PREVIEW = "--enable-preview"
    withType<JavaCompile>() {
        options.compilerArgs.add(ENABLE_PREVIEW)
        options.compilerArgs.add("-Xlint:preview")
        options.release.set(20)
    }
    withType<Test>().all {
        useJUnitPlatform()
        jvmArgs(ENABLE_PREVIEW)
        minHeapSize = "512m"
        maxHeapSize = "4g"
        systemProperties["junit.jupiter.execution.parallel.enabled"] = "false"
        systemProperties["junit.jupiter.execution.parallel.mode.default"] = "concurrent"
        systemProperties["junit.jupiter.execution.parallel.mode.classes.default"] = "concurrent"
    }
    withType<JavaExec>().all {
        jvmArgs(ENABLE_PREVIEW)
    }
    withType<KotlinCompile> {
        kotlinOptions.jvmTarget = "19"
    }
}

原因分析 #

1. FFM是Java 20的预览特性，编译阶段必须指定目标Java版本为20并启用预览特性，否则编译器无法识别Arena等FFM相关API。
2. 旧版Kotlin（如1.8.x及之前）未支持JVM target 20，导致无法直接设置Kotlin编译目标为20。
3. Gradle强制要求Java与Kotlin的编译目标版本一致，避免跨版本字节码兼容问题，因此会抛出版本不匹配的错误。

变通方案 #

方案1：升级Kotlin版本至支持JVM Target 20的版本 #

Kotlin 1.9.0及以上版本已支持JVM target 20，先在build.gradle.kts中升级Kotlin插件：

plugins {
    kotlin("jvm") version "1.9.20" // 或更高稳定版本
    // 其他项目插件
}

然后统一Java与Kotlin的编译配置，确保版本一致并启用预览特性：

tasks {
    val ENABLE_PREVIEW = "--enable-preview"
    
    withType<JavaCompile> {
        options.compilerArgs.add(ENABLE_PREVIEW)
        options.compilerArgs.add("-Xlint:preview")
        options.release.set(20)
    }
    
    withType<KotlinCompile> {
        kotlinOptions.jvmTarget = "20"
        kotlinOptions.freeCompilerArgs.add(ENABLE_PREVIEW) // Kotlin也需启用预览特性
    }
    
    withType<Test>().all {
        useJUnitPlatform()
        jvmArgs(ENABLE_PREVIEW)
        // 保留原有测试堆内存、并行配置
    }
    
    withType<JavaExec>().all {
        jvmArgs(ENABLE_PREVIEW)
    }
}

最后确保项目使用Java 20 SDK：在gradle.properties中指定JDK路径，或在IDE中设置项目SDK为Java 20。

org.gradle.java.home=/path/to/your/java20/jdk

方案2：临时封装Java层（无法升级Kotlin版本时） #

如果必须使用不支持JVM 20的旧版Kotlin，可以：

1. 将所有FFM相关的调用逻辑封装到Java类中，用Java 20编译并启用预览特性。
2. 在Kotlin代码中调用这些封装好的Java类，此时Kotlin可保持JVM target 19，但运行时必须使用Java 20并添加--enable-preview参数。

注意：这种方式需确保Java与Kotlin编译产物的兼容性，且所有运行任务（包括测试、执行）都必须启用预览特性。

关键结论 #

• FFM作为预览特性，编译阶段必须指定Java 20目标版本并启用预览，仅在Java 20环境运行但用Java 19编译无法识别FFM API。
• Gradle的版本一致性检查是必要的，必须保证Java与Kotlin编译目标版本匹配。
• 升级到支持JVM 20的Kotlin版本是最直接、长期的解决方案。

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