本文详解在 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<Test>() {
useJUnitPlatform()
jvmArgs!!.add(ENABLE_PREVIEW) // ❌ 危险写法：jvmArgs 可能为 null，且 add() 不安全
}存在两个隐患：
- jvmArgs!! 强制解包可能触发空指针异常（尤其在较新 Gradle 版本中）；
- add() 是就地修改，不如声明式 API 清晰可靠。
✅ 正确做法是使用 jvmArgs(...) 方法（接受可变参数），它会安全初始化并覆盖默认参数：
立即学习“Java免费学习笔记（深入）”；
tasks.withType<Test> {
useJUnitPlatform()
jvmArgs("--enable-preview") // ✅ 推荐：简洁、安全、语义明确
}
tasks.withType<JavaExec> {
jvmArgs("--enable-preview")
}
// 编译阶段同样需启用（已正确配置）
tasks.withType<JavaCompile> {
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 集成也要开。
