如何验证Spring Boot微服务中是否使用了Virtual Threads？

一、验证是否使用虚拟线程 #

1. 代码层面直接校验 #

在RestClient调用的逻辑中添加日志，通过API直接判断线程类型，这是最权威的验证方式：

// 用日志框架输出更规范
log.debug("当前线程名: {}, 是否为虚拟线程: {}", 
          Thread.currentThread().getName(),
          Thread.currentThread().isVirtual());

线程名称可能存在误导，但Thread.currentThread().isVirtual()的返回值是判断虚拟线程的唯一准确依据。

2. JDK工具排查 #

• jconsole/jvisualvm：连接运行中的应用，打开线程面板，虚拟线程会被明确标记为「Virtual Thread」，名称通常带有virtual-前缀（支持自定义），且同一平台线程会关联多个虚拟线程。
• jstack：执行jstack <进程ID>导出线程栈，虚拟线程的栈信息中会包含java.lang.VirtualThread字样，可与平台线程的java.lang.Thread标识区分。

二、启用虚拟线程的关键配置与注意点 #

1. 确保Web服务器适配虚拟线程 #

你使用的Undertow仅靠spring.threads.virtual.enabled=true可能无法完全切换到虚拟线程，需要额外配置线程池参数：

# application.properties
spring.threads.virtual.enabled=true
server.undertow.worker-threads=0  # 设置为0表示让Undertow使用虚拟线程处理请求

Spring Boot 3.4.x对Tomcat、Jetty、Undertow均做了虚拟线程适配，但部分服务器需要显式配置线程池参数才能触发。如果Web请求仍由undertow-xx这类平台线程处理，后续RestClient调用也会继承该线程上下文。

2. RestClient的虚拟线程上下文 #

RestClient本身无需额外配置，但要确保它的调用是在虚拟线程上下文发起的。只有当Web服务器用虚拟线程处理入口请求时，RestClient才会在虚拟线程上执行。

3. 避开线程绑定陷阱 #

虚拟线程不建议绑定可变的ThreadLocal资源，若应用中有自定义ThreadLocal变量，可能导致资源泄漏或逻辑错误，建议改用InheritableThreadLocal（仅适合不可变或线程安全的资源）。

三、常见误区 #

• 线程名称误导：虚拟线程附着在平台线程执行时，日志显示的可能是平台线程名称，不能仅凭undertow-xx就判断未使用虚拟线程，必须用isVirtual()方法校验。
• 全局开关不等于全场景生效：spring.threads.virtual.enabled=true是全局开关，但自定义线程池等组件需要单独适配，Web服务器的线程池配置是触发虚拟线程的关键。

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