JDK21虚拟线程特性环境安装配置指南-java教程-PHP中文网

jdk 21虚拟线程需满足三要素：一是使用jdk 21+完整版（非jre），二是正确配置java_home和path环境变量，三是运行时必须添加--enable-preview参数；否则thread.ofvirtual()将不可用或抛出异常。

jdk21虚拟线程特性环境安装配置指南

JDK 21 虚拟线程不是装完 JDK 就能直接用的特性，它依赖正确的版本、环境配置和运行时参数。核心前提是：必须使用 JDK 21 或更高版本（如 21.0.5），且启动时显式启用预览特性 --enable-preview。

确认 JDK 版本与完整构建

虚拟线程在 JDK 21 中仍是预览特性（直到 JDK 22 才正式转正），因此对 JDK 构建完整性有明确要求：

必须是完整版 JDK，而非精简 JRE（例如某些 Alpine Linux 容器镜像中的 jdk21-jre-headless 可能缺失 java.lang.VirtualThread 类）；
推荐使用主流发行版：Oracle JDK、Eclipse Temurin、Amazon Corretto 或 Microsoft Build of OpenJDK，它们均提供标准完整构建；
安装后验证命令：java -version 输出应包含 21.x.x，且 javac -version 一致；
路径中不能含中文或空格（如 D:\Java\jdk-21.0.5 合规，C:\Program Files\Java\jdk-21 虽常见但建议避开空格）。

正确配置 JAVA_HOME 和 Path

IDE 和命令行工具依赖系统环境变量识别 JDK，错误配置会导致编译或运行时找不到虚拟线程类：

Flova

Flova是一款AI文本写作工具，全球首个一体化 AI 视频创作平台。

下载

新建系统变量 JAVA_HOME，值为 JDK 21 根目录（例如 D:\Java\jdk-21.0.5）；
编辑系统变量 Path，新增两行：
%JAVA_HOME%\bin
%JAVA_HOME%\jre\bin（部分构建不含 jre 目录，可省略第二行）；
务必删除旧 JDK 的绝对路径（如 C:\Program Files (x86)\Common Files\Oracle\Java\javapath），避免版本冲突；
配置后重启所有终端窗口，再执行 where java（Windows）或 which java（macOS/Linux），确保返回路径指向 JDK 21 的 bin 目录。

运行时必须加 --enable-preview 参数

即使 JDK 版本正确，漏掉该参数会导致 Thread.ofVirtual() 找不到或抛出 UnsupportedOperationException：

命令行运行：用 java --enable-preview -jar app.jar 或 java --enable-preview YourMainClass；
IDEA 中需在 Run Configuration → VM Options 栏手动输入 --enable-preview（仅改 Project SDK 不生效）；
Maven 编译需在 pom.xml 的 maven-compiler-plugin 中指定：
<source>21</source>
<target>21</target>
<compilerargs><arg>--enable-preview</arg></compilerargs>；
Gradle 用户需在 compileJava 和 java tasks 中分别添加 --enable-preview 参数。

编写与运行第一个虚拟线程示例

语法和生命周期管理与传统线程不同，直接调用 start() 或 join() 会出错：

创建方式应为：Thread.ofVirtual().start(() -> { /* 任务逻辑 */ });；
避免在虚拟线程内调用 Thread.sleep() 或 Object.wait()，否则会退化为平台线程阻塞；
不推荐裸用 start()，应优先采用 StructuredTaskScope 进行结构化并发管理；

示例结构化写法：

try (var scope = new StructuredTaskScope.ShutdownOnFailure()) {
    scope.fork(() -> {
        System.out.println("虚拟线程执行");
        return "done";
    });
    scope.join();
    scope.throwIfFailed();
}

这样可自动传播异常、统一超时控制、防止线程泄漏。