虚拟线程卡住主因是同步阻塞调用未释放载体线程；高吞吐定时任务禁用newVirtualThreadPerTaskExecutor；Spring @Async需自定义TaskExecutor才能启用虚拟线程。
虚拟线程一启动就卡住？检查是否在同步阻塞调用里没释放载体线程
Java 21 的 VirtualThread 不是“万能不卡线程”，它依赖载体线程（Carrier Thread）执行实际工作。一旦你在 virtualThread.start() 后立刻调用 Thread.sleep()、Object.wait()、文件读写、传统 JDBC 查询等**未适配结构化并发的阻塞操作**，虚拟线程会把当前载体线程“占住”，导致后续虚拟线程排队等待——看起来像全卡了。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 优先用 JDK 21+ 新增的异步 I/O API，比如
FileChannel.read(..., AysncHandler)或HttpClient的sendAsync()方法 - 对已有阻塞调用，包裹进
Thread.ofVirtual().unstarted(runnable)+Thread.start()是不够的；必须确保该 runnable 内部不触发同步阻塞，或改用StructuredTaskScope配合join()等非阻塞等待 - 验证是否真卡：用
jcmd <pid> VM.native_memory summary</pid>查看线程数是否远低于预期；再用jstack <pid></pid>搜索java.lang.VirtualThread状态，大量WAITING且堆栈含Unsafe.park就是被阻塞住了
为什么 ExecutorService.newVirtualThreadPerTaskExecutor() 不适合高吞吐定时任务
这个工厂方法看似方便，但它每次提交都新建一个 VirtualThread 实例，不复用、不缓存。对短生命周期任务没问题，但若你用它跑每秒几百次的 ScheduledExecutorService.scheduleAtFixedRate()，会快速堆积大量已终止但尚未被 GC 回收的虚拟线程对象，引发频繁 GC，甚至 OutOfMemoryError: Metaspace（因每个 VirtualThread 在 JVM 内部有元数据开销）。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 定时类场景改用
Thread.ofPlatform().factory().newThread(runnable)+ 手动管理线程复用，或直接用ScheduledThreadPoolExecutor - 若坚持用虚拟线程，应配合
StructuredTaskScope控制生命周期，例如在单次调度中 spawn 多个子虚拟线程并统一close() - 注意：JDK 当前不提供
VirtualThread版本的ScheduledExecutorService，别试图包装newVirtualThreadPerTaskExecutor()去模拟
Spring Boot 6.2+ 怎么让 @Async 默认走虚拟线程
Spring 默认仍用 ThreadPoolTaskExecutor，即使你启用了 Java 21 虚拟线程，@Async 方法也照旧跑在平台线程池里。要切换过去，不是加个配置就行，得重写 TaskExecutor Bean 并绕过 Spring 对线程池的默认校验逻辑。
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 定义 Bean 时不要返回
ExecutorService，而要返回TaskExecutor接口实现，否则 Spring 会尝试调用shutdown()—— 虚拟线程执行器不支持这个操作，会抛UnsupportedOperationException - 推荐写法：
@Bean public TaskExecutor taskExecutor() { return command -> Thread.ofVirtual().unstarted(command).start(); } - 注意：这样写的执行器无法做拒绝策略、队列控制、线程名定制；如需这些能力，得自己封装一个轻量级
VirtualThreadTaskExecutor类，内部用Thread.Builder控制命名和异常处理器
虚拟线程 dump 不显示完整堆栈？那是 jstack 还没完全适配
用 jstack <pid></pid> 查看虚拟线程时，常见现象是只看到 java.lang.VirtualThread$VThreadContinuation 和几行 run 调用，真实业务代码堆栈“消失”了。这不是你的代码问题，而是 JDK 21 初期 jstack 对协程式调度的堆栈展开支持不完整，尤其当虚拟线程处于 park 状态时。
实操建议：
立即学习“Java免费学习笔记（深入）”；
- 优先用
jcmd <pid> VM.native_memory summary</pid>+jcmd <pid> Thread.print</pid>组合，后者对虚拟线程堆栈识别更准 - 开发阶段加日志：在关键入口处打
Thread.currentThread().getName()，虚拟线程名默认含virtual-thread-前缀，可快速确认是否真进了 VT - 别依赖 IDE 的“Debug → Suspend All Threads”来观察虚拟线程状态——多数 IDE 调试器尚未处理好 VT 的挂起/恢复语义，容易误判为死锁
虚拟线程不是线程数量的魔法开关，它是把“阻塞即资源浪费”这个前提推到极致后的产物。真正难的从来不是启动一万条虚拟线程，而是确保它们中间没有一处偷偷调用了 System.in.read()、没漏掉一个 synchronized 块、也没在日志框架里埋下 ThreadLocal 泄漏的坑。
