如何在 Gradle 项目中为测试正确启用 Java 预览特性

本文详解在 java 19 中使用 foreign function & memory api（预览特性）时，为何测试运行失败、主程序却正常，并提供 gradle 配置的完整修复方案，确保编译、测试与执行阶段均正确启用 `--enable-preview`。

在 Java 19 中启用预览特性（如 Foreign Function & Memory API）时，仅配置编译器参数是不够的——JVM 运行时也必须显式启用 --enable-preview，否则会抛出 UnsupportedClassVersionError，提示“Preview features are not enabled for XXX (class file version 63.65535)”。你遇到的问题正源于此：虽然 src/main 下的 main() 方法能成功运行，但 src/test 中的 JUnit 测试因 JVM 启动参数缺失而失败。

关键在于：Gradle 的 Test 任务默认不继承 javaCompile 的 JVM 参数，必须单独为测试 JVM 显式配置 --enable-preview。你当前的配置中：

withType() {
    useJUnitPlatform()
    jvmArgs!!.add(ENABLE_PREVIEW) // ❌ 危险写法：jvmArgs 可能为 null，且 add() 不安全
}

存在两个隐患：

1. jvmArgs!! 强制解包可能触发空指针异常（尤其在较新 Gradle 版本中）；
2. add() 是就地修改，不如声明式 API 清晰可靠。

✅ 正确做法是使用 jvmArgs(...) 方法（接受可变参数），它会安全初始化并覆盖默认参数：

AVCLabs

AI移除视频背景，100%自动和免费

下载

立即学习“Java免费学习笔记（深入）”；

tasks.withType {
    useJUnitPlatform()
    jvmArgs("--enable-preview") // ✅ 推荐：简洁、安全、语义明确
}

tasks.withType {
    jvmArgs("--enable-preview")
}

// 编译阶段同样需启用（已正确配置）
tasks.withType {
    options.compilerArgs.addAll(listOf("--enable-preview", "-Xlint:preview"))
    options.release.set(19)
}

java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(19))
    }
}

⚠️ 额外注意事项：

• IntelliJ 用户必看：即使 Gradle 配置正确，IntelliJ 默认仍使用自己的测试运行器 JVM 参数。需手动设置：
  File → Settings → Build, Execution, Deployment → Gradle → Runner → 勾选 "Delegate IDE build/run actions to Gradle"，并确保 Run tests using: 选择 "Gradle Test Runner"。否则 IntelliJ 会忽略 jvmArgs，导致测试仍失败。
• 若项目含 Kotlin 代码，还需同步配置 Kotlin 编译器目标版本（你已正确设置 kotlinOptions.jvmTarget = "19"）。
• --release 19 与 --enable-preview 可共存，但 --release 会限制 API 使用范围，确保所用预览特性在 JDK 19 中确实可用（FFM API 在 Java 19 确属预览状态）。

完成上述配置后，执行 ./gradlew test 或在 IntelliJ 中右键运行测试类，即可成功加载 netcdf_h.java 并调用 FFM API。总结一句话：预览特性的启用是端到端的——编译要开、运行要开、IDE 集成也要开。