Spring Webflux配置单线程处理请求，server.tomcat.max-threads=1无效

首先要明确：Spring Webflux默认采用Netty作为底层容器，你配置的server.tomcat.max-threads=1属于Servlet栈（Spring MVC）的参数，对Webflux完全不生效，这就是为什么你仍看到多线程的原因。要实现单线程处理所有请求，需要针对Netty的线程模型和业务逻辑调度做如下配置：

1. 配置Netty事件循环线程数为1 #

在application.properties或application.yml中添加以下配置，将Netty的连接接收线程和请求处理线程都设为1：

application.properties： #

# 设置Netty的工作线程数（处理请求）
server.netty.event-loop.group-threads=1
# 设置Netty的Boss线程数（接受新连接）
server.netty.event-loop.boss-threads=1

application.yml： #

server:
  netty:
    event-loop:
      group-threads: 1
      boss-threads: 1

2. 确保业务逻辑不切换线程 #

即使Netty的事件循环是单线程，若业务代码中使用了block()、默认的并行调度器（如Flux.parallel()）或其他线程池，仍会触发线程切换。你需要强制所有业务逻辑运行在Netty的事件循环线程上：

自定义调度器与WebFilter #

创建配置类，将Netty的事件循环包装为调度器，并通过WebFilter让所有请求的处理链路都绑定到该线程：

@Configuration
public class SingleThreadProcessingConfig {

    // 获取Netty的事件循环组，包装为Reactor调度器
    @Bean
    public Scheduler nettyEventLoopScheduler(ReactorResourceFactory reactorResourceFactory) {
        EventLoopGroup eventLoopGroup = reactorResourceFactory.getLoopResources().onServer(false);
        return Schedulers.fromExecutor(eventLoopGroup);
    }

    // 配置WebFilter，强制所有请求处理在Netty事件循环线程上执行
    @Bean
    public WebFilter singleThreadEnforcingFilter(Scheduler nettyEventLoopScheduler) {
        return (exchange, chain) -> chain.filter(exchange)
                .subscribeOn(nettyEventLoopScheduler)
                .publishOn(nettyEventLoopScheduler);
    }
}

3. 确保应用使用Netty而非Tomcat启动 #

如果你的项目中不小心引入了Servlet栈的依赖（如spring-boot-starter-web），需要替换为Webflux依赖并排除Tomcat：

Maven依赖调整： #

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-webflux</artifactId>
    <exclusions>
        <exclusion>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-tomcat</artifactId>
        </exclusion>
    </exclusions>
</dependency>

Gradle依赖调整： #

implementation 'org.springframework.boot:spring-boot-starter-webflux'
implementation.exclude group: 'org.springframework.boot', module: 'spring-boot-starter-tomcat'

完成以上配置后，你的Webflux应用将仅使用单个线程处理所有连接和请求逻辑。

内容的提问来源于stack exchange，提问作者John R. Martinez