本文介绍如何在 spring boot 2.x（集成 undertow 1.4+）中获取 undertow 内置的默认 i/o 线程数与工作线程池大小，并通过自定义工厂配置实时查看其值。
本文介绍如何在 spring boot 2.x（集成 undertow 1.4+）中获取 undertow 内置的默认 i/o 线程数与工作线程池大小，并通过自定义工厂配置实时查看其值。
在 Spring Boot 应用中，当使用 Undertow 作为嵌入式 Web 容器时，其底层线程模型由两组关键参数控制：I/O 线程（io-threads） 和 工作线程（worker-threads）。需注意：Undertow 并不使用传统“线程队列”（如阻塞队列 BlockingQueue）来缓冲待处理请求；它采用基于 XNIO 的事件驱动架构，请求由 I/O 线程接收后，立即分发至工作线程池执行业务逻辑。因此，所谓“thread queue size”在 Undertow 语境中通常指工作线程池的任务等待队列容量（即 queueSize），但该值默认为无界（Integer.MAX_VALUE），实际受 worker-threads 数量和系统资源约束。
Spring Boot 2.0.8.RELEASE 默认使用的 Undertow 版本（1.4.2.Final）中，相关默认值如下：
- io-threads：默认为 Runtime.getRuntime().availableProcessors()（即 CPU 核心数）
- worker-threads：默认为 io-threads × 8（即 CPU 核心数 × 8），最小值为 20
- 工作线程池的内部队列（XnioWorker.TaskPool）无显式队列长度限制，任务提交行为等效于无界队列
要验证或调试这些值，可通过 UndertowServletWebServerFactory 的构建器（Undertow.Builder）在容器初始化早期读取配置。推荐方式是注册 UndertowWebServerFactoryCustomizer Bean，如下所示：
import org.springframework.boot.autoconfigure.web.embedded.UndertowWebServerFactoryCustomizer;
import org.springframework.boot.web.embedded.undertow.UndertowServletWebServerFactory;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
@Configuration
public class UndertowConfig {
@Bean
public UndertowWebServerFactoryCustomizer undertowWebServerFactoryCustomizer() {
return factory -> {
int ioThreads = factory.getBuilder().getIoThreads();
int workerThreads = factory.getBuilder().getWorkerThreads();
System.out.println("Undertow I/O threads (io-threads): " + ioThreads);
System.out.println("Undertow worker threads (worker-threads): " + workerThreads);
// 注意：Undertow 不暴露 queueSize 属性；其任务队列由 XNIO 自动管理，无硬性上限
};
}
}✅ 注意事项：
- getIoThreads() 和 getWorkerThreads() 返回的是当前已生效的配置值，若已在 application.yml 中显式配置（如 server.undertow.io-threads=4），此处将输出覆盖后的值；
- Undertow 的 worker-threads 对应 XnioWorker 中的线程池，其底层使用 SynchronousQueue + 动态扩容策略，不提供可配置的 queueSize 参数——这是与 Tomcat（max-queue-size）或 Netty 的关键差异；
- 若需控制并发请求数，应优先通过限流组件（如 Resilience4j、Sentinel）或反向代理（如 Nginx）实现，而非依赖 Undertow 队列；
- 修改线程数需权衡：过多线程会增加上下文切换开销；过少则可能导致请求堆积（尤其在高延迟 I/O 场景下）。
总结而言，在 Spring Boot + Undertow 架构中，应关注 io-threads 与 worker-threads 的合理配比（建议保持 worker-threads ≥ io-threads × 4），并理解其异步非阻塞本质——它没有传统意义的“请求等待队列”，而是通过高效的任务分发与线程复用支撑高吞吐场景。
