如何让Java库支持Virtual Threads并兼容Java 11及更早版本

要同时兼容Java 11+并在Java 21+环境下利用虚拟线程，核心是隔离版本差异，通过抽象、动态加载和编译配置实现无冲突运行，具体方案如下：

1. 用工厂模式抽象线程创建逻辑 #

把线程创建逻辑封装成抽象接口，让不同Java版本使用对应的实现类，业务代码完全不直接依赖虚拟线程API：

// 抽象线程工厂提供者
public interface ThreadFactoryProvider {
    ThreadFactory getThreadFactory();
}

// Java 11+通用实现（普通线程）
public class DefaultThreadFactoryProvider implements ThreadFactoryProvider {
    @Override
    public ThreadFactory getThreadFactory() {
        return Executors.defaultThreadFactory();
    }
}

// Java 21+专属实现（虚拟线程）
public class VirtualThreadFactoryProvider implements ThreadFactoryProvider {
    @Override
    public ThreadFactory getThreadFactory() {
        return Thread.ofVirtual().factory();
    }
}

2. 运行时版本检测+动态加载 #

通过系统属性判断Java版本，仅在Java 21+环境下加载虚拟线程相关类，避免旧版本出现类加载错误：

public class ThreadFactoryLoader {
    public static ThreadFactoryProvider loadProvider() {
        int majorVersion = parseJavaMajorVersion(System.getProperty("java.version"));
        if (majorVersion >= 21) {
            try {
                // 动态加载虚拟线程工厂类，旧版本不会触发此逻辑
                Class<?> clazz = Class.forName("com.yourlib.util.VirtualThreadFactoryProvider");
                return (ThreadFactoryProvider) clazz.getDeclaredConstructor().newInstance();
            } catch (Exception e) {
                // 加载失败降级为普通线程
                return new DefaultThreadFactoryProvider();
            }
        } else {
            return new DefaultThreadFactoryProvider();
        }
    }

    // 处理Java版本格式（兼容1.8、11、21等写法）
    private static int parseJavaMajorVersion(String version) {
        if (version.startsWith("1.")) {
            return Integer.parseInt(version.substring(2, 3));
        }
        return Integer.parseInt(version.split("[._]")[0]);
    }
}

3. 编译层面的兼容配置 #

• 以Java 11为基础编译目标，用--release 11参数确保主代码不引入Java 21专属API；
• 用构建工具的Profile区分版本编译，比如Maven配置：

<profiles>
    <profile>
        <id>java-21</id>
        <activation><jdk>21</jdk></activation>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.11.0</version>
                    <configuration><release>21</release></configuration>
                </plugin>
            </plugins>
        </build>
    </profile>
    <profile>
        <id>java-11</id>
        <activation><jdk>[11,21)</jdk></activation>
        <build>
            <plugins>
                <plugin>
                    <groupId>org.apache.maven.plugins</groupId>
                    <artifactId>maven-compiler-plugin</artifactId>
                    <version>3.11.0</version>
                    <configuration><release>11</release></configuration>
                </plugin>
            </plugins>
        </build>
    </profile>
</profiles>

4. 关键注意事项 #

• 所有涉及Thread.ofVirtual()的代码必须放在单独类中，绝对不能在主逻辑中直接引用；
• 测试时要覆盖Java 11、17、21等多个版本，验证线程创建逻辑的正确性；
• 若使用线程池，可同理抽象ExecutorService的创建逻辑，Java 21下用Executors.newVirtualThreadPerTaskExecutor()。

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