虚拟线程适配无需修改业务代码，只需替换执行载体为VirtualThreadPerTaskExecutor或启用Spring Boot虚拟线程支持，注意ThreadLocal、同步锁和第三方库阻塞调用三大兼容边界。
不需要“一键升级”，也没有所谓“无损管道”。虚拟线程不是魔法开关，它不改变任务逻辑，也不自动修复设计缺陷。真正可行的路径是：保留原有 runnable 代码不动，只替换执行载体——把它们从平台线程池里抽出来，交给虚拟线程调度器运行。
直接复用旧 Runnable，不改一行业务逻辑
你现有的 Runnable 实例（比如处理 HTTP 请求、读数据库、调第三方 API 的任务）完全兼容虚拟线程。JVM 不关心任务是不是“为虚拟线程写的”，只关心它能不能被调度执行。
- 不用重写
run()方法，也不用改成Supplier或Callable - 无需引入响应式类型（如
Mono、Flux），阻塞写法照常可用 - 原有日志、异常捕获、事务注解（如
@Transactional）在 Spring 环境下仍生效
用 VirtualThreadPerTaskExecutor 替换传统线程池
这是最轻量、最安全的接入方式。它为每个 Runnable 分配一个虚拟线程，底层自动复用少量平台线程，无需手动管理生命周期。
try (var executor = Executors.newVirtualThreadPerTaskExecutor()) {
for (Runnable task : legacyTaskList) {
executor.submit(task); // 直接 submit 原始 Runnable
}
}
- 适用于批量提交、定时调度、消息消费等场景
- 执行完自动关闭，避免资源泄漏；也可长期持有作为全局执行器
- 若需命名或异常统一处理，可用
Thread.ofVirtual().factory()构建自定义工厂
适配 Spring Boot：注入虚拟线程执行器替代默认池
如果你用的是 Spring MVC 或 Spring Task（@Scheduled），只需配置启用虚拟线程支持，框架会自动将请求和定时任务路由到虚拟线程上。
spring.task.execution.virtual-threads.enabled=true
- Tomcat/Jetty 接收每个 HTTP 请求时，自动使用虚拟线程执行 Controller 方法
-
@Scheduled任务不再争抢固定线程池，每个任务独占轻量虚拟线程 - 原有
TaskExecutor注入点（如@Autowired TaskExecutor taskExecutor）会自动指向虚拟线程实现
注意三个关键兼容边界
旧代码能跑，不代表所有行为都“透明迁移”。以下三点必须检查：
-
ThreadLocal 变量：虚拟线程数量激增后，未清理的
ThreadLocal容易引发内存泄漏，建议改用ScopedValue（Java 22+）或显式 remove -
同步锁竞争：如果大量虚拟线程争抢同一把
synchronized或ReentrantLock，会退化为串行，吞吐不升反降 -
第三方库阻塞调用：部分老库（如某些 JDBC 驱动旧版本）内部使用
Object.wait()或Unsafe.park()，可能干扰挂起机制，建议升级到支持 Loom 的版本
本质上，虚拟线程适配器不是升级任务，而是升级执行环境。你的 Runnable 还是那个 Runnable，只是现在跑在更薄、更快、更密集的调度层上。
