spring boot 全局异常处理默认无法捕获 virtualthread（虚拟线程）抛出的异常，因为虚拟线程运行在平台线程池之外，其未捕获异常不会触发平台的 uncaughtexceptionhandler。要解决这个问题，必须通过 virtualthreadfactory 注册自定义的 uncaughtexceptionhandler，并在其中将异常包装为 runtimeexception 或直接调用 spring 的全局异常处理器逻辑。
如何配置 VirtualThreadFactory 以捕获异常
通过实现 Thread.UncaughtExceptionHandler 接口并将其传递给 VirtualThreadFactory，可以拦截所有在虚拟线程中发生的未处理异常。该处理器需要获取当前的 RequestContextHolder 或手动构建响应对象，以便与 Spring MVC 的异常处理机制集成。
import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; import org.springframework.context.annotation.Bean; import org.springframework.web.servlet.mvc.method.annotation.ResponseEntityExceptionHandler; import java.lang.Thread.UncaughtExceptionHandler; import java.util.concurrent.Executors; import java.util.concurrent.ThreadFactory; @SpringBootApplication public class Application { public static void main(String[] args) { SpringApplication.run(Application.class, args); } @Bean public ThreadFactory virtualThreadFactory() { return new ThreadFactory() { private final ThreadFactory defaultFactory = Executors.defaultThreadFactory(); @Override public Thread newThread(Runnable r) { Thread t = defaultFactory.newThread(r); if (t instanceof Thread.Virtual) { t.setUncaughtExceptionHandler((thread, ex) -> { System.err.println("Virtual Thread Exception: " + ex.getMessage()); }); } return t; } }; } }
上述代码展示了如何在启动时注册一个工厂，该工厂为每个新创建的虚拟线程设置异常处理器。当异常发生时，处理器会打印错误信息，但在生产环境中，应将其转发给 Spring 的全局异常处理链。
如何将异常转发至 Spring 全局处理器
为了将虚拟线程中的异常纳入 Spring 的全局异常处理流程，需要在自定义的 UncaughtExceptionHandler 中注入或访问 HandlerExceptionResolver。这允许异常被转换为标准的 HTTP 响应，而不是仅仅打印到控制台。
import org.springframework.stereotype.Component; import org.springframework.web.servlet.HandlerExceptionResolver; import org.springframework.web.servlet.ModelAndView; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.lang.Thread.UncaughtExceptionHandler; import java.util.concurrent.Executors; import java.util.concurrent.ThreadFactory; @Component public class VirtualThreadExceptionHandler implements UncaughtExceptionHandler { private final HandlerExceptionResolver resolver; public VirtualThreadExceptionHandler(HandlerExceptionResolver resolver) { this.resolver = resolver; } @Override public void uncaughtException(Thread t, Throwable e) { HttpServletRequest request = null; HttpServletResponse response = null; try { // 假设通过某种方式获取当前请求上下文，例如使用 RequestContextHolder request = (HttpServletRequest) RequestContextHolder.currentRequestAttributes().resolveReference(RequestContextHolder.SERVLET_REQUEST); response = (HttpServletResponse) RequestContextHolder.currentRequestAttributes().resolveReference(RequestContextHolder.SERVLET_RESPONSE); } catch (Exception ex) { // 如果无法获取请求上下文，则记录日志并忽略 System.err.println("Failed to resolve request context for exception handling"); return; } ModelAndView mav = resolver.resolveException(request, response, null, e); if (mav == null) { System.err.println("Exception not resolved by Spring: " + e.getMessage()); } } }
此代码片段展示了如何将异常解析器注入到处理器中，并在捕获到异常时尝试解析请求和响应对象。如果成功，它将调用 HandlerExceptionResolver 来处理异常，从而确保全局异常处理的逻辑被执行。需要注意的是，由于虚拟线程可能不在 Web 请求的上下文中运行，因此获取 HttpServletRequest 和 HttpServletResponse 可能会失败，此时应回退到默认的日志记录行为。
虚拟线程异常处理中的上下文丢失问题
在使用虚拟线程时，由于它们不是由应用服务器管理的平台线程，因此无法直接利用传统的线程局部变量（如 ThreadLocal）来传递请求上下文。这导致在全局异常处理中难以获取当前的 HttpServletRequest 和 HttpServletResponse 对象。
为了解决这个问题，可以使用 InheritableThreadLocal 或 TransmittableThreadLocal 来显式传递上下文。在发起虚拟线程之前，将必要的请求属性复制到这些线程局部变量中，然后在异常处理器中读取它们。这种方法虽然增加了复杂性，但能确保异常处理逻辑能够访问到足够的上下文信息来生成适当的响应。
