Spring Boot 1.5.x：如何为EndpointWebMvc配置Undertow线程池？

这个问题我之前在做Spring Boot项目时也碰到过——因为Actuator的管理上下文是完全独立的子ApplicationContext，主上下文里配置的Undertow线程池或者自定义的UndertowServletWebServerFactory（旧版本为UndertowEmbeddedServletContainerFactory）根本不会被管理上下文继承，所以才会出现共用线程池、自定义配置不生效的情况。下面给你一套可行的解决方案：

核心思路 #

给管理上下文单独配置专属的Undertow线程池，需要借助Spring Boot提供的@ManagementContextConfiguration注解，让配置类只在管理上下文中生效，同时自定义management.undertow前缀的配置属性来区分主应用和管理端的参数。

步骤1：自定义管理端Undertow配置属性类 #

先创建一个类来绑定management.undertow前缀的配置参数，这样就能在配置文件里单独设置管理端的线程池大小：

import io.undertow.UndertowOptions;
import org.springframework.boot.context.properties.ConfigurationProperties;

@ConfigurationProperties(prefix = "management.undertow")
public class ManagementUndertowProperties {
    // 默认值和Undertow默认保持一致
    private int ioThreads = UndertowOptions.DEFAULT_IO_THREADS;
    private int workerThreads = UndertowOptions.DEFAULT_WORKER_THREADS;

    // Getter和Setter方法
    public int getIoThreads() {
        return ioThreads;
    }

    public void setIoThreads(int ioThreads) {
        this.ioThreads = ioThreads;
    }

    public int getWorkerThreads() {
        return workerThreads;
    }

    public void setWorkerThreads(int workerThreads) {
        this.workerThreads = workerThreads;
    }
}

步骤2：创建管理上下文专属的Undertow配置类 #

用@ManagementContextConfiguration标注这个配置类，确保它只会被管理上下文加载，然后在里面定义专属的UndertowServletWebServerFactory（Spring Boot 3.x使用该类，2.x旧版本可替换为UndertowEmbeddedServletContainerFactory）：

import org.springframework.boot.actuate.autoconfigure.web.ManagementContextConfiguration;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.boot.web.embedded.undertow.UndertowServletWebServerFactory;
import org.springframework.context.annotation.Bean;

@ManagementContextConfiguration
@EnableConfigurationProperties(ManagementUndertowProperties.class)
public class ManagementUndertowConfiguration {

    @Bean
    public UndertowServletWebServerFactory managementUndertowWebServerFactory(ManagementUndertowProperties properties) {
        UndertowServletWebServerFactory factory = new UndertowServletWebServerFactory();
        // 给管理端Undertow实例设置专属线程池
        factory.addBuilderCustomizers(builder -> {
            builder.setIoThreads(properties.getIoThreads());
            builder.setWorkerThreads(properties.getWorkerThreads());
            // 这里还可以添加其他Undertow自定义配置，比如buffer大小、HTTP协议等
        });
        return factory;
    }
}

步骤3：让Spring Boot识别管理上下文配置类 #

在项目的src/main/resources/META-INF目录下创建spring.factories文件，添加以下内容，告诉Spring Boot这个配置类属于管理上下文：

org.springframework.boot.actuate.autoconfigure.web.ManagementContextConfiguration=com.yourpackage.ManagementUndertowConfiguration

注意把com.yourpackage替换成你实际的包路径。

步骤4：在配置文件中分别配置参数 #

现在就可以在application.properties（或application.yml）里分别设置主应用和管理端的Undertow线程池了：

# 主应用Undertow配置
server.undertow.io-threads=8
server.undertow.worker-threads=32
server.port=8080

# 管理端专属Undertow配置
management.undertow.io-threads=4
management.undertow.worker-threads=16
management.port=8081

为什么之前的方法不生效？ #

• 主上下文的UndertowEmbeddedServletContainerFactory是主应用的Bean，管理上下文作为独立的子上下文，不会继承主上下文的WebServer相关Bean；
• Spring Boot默认没有提供management.undertow前缀的原生属性，所以必须自己绑定自定义属性，再通过管理上下文专属配置类来应用。

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