如何在Spring Boot中以Netty为HTTP服务器配置requestTimeout？

为什么Spring Boot默认不支持配置文件配置？ #

Spring Boot的自动配置逻辑优先覆盖通用、高频的Web场景配置，而Netty的requestTimeout属于Reactor Netty底层的细粒度配置，不属于Webflux自动配置默认暴露的配置项范畴，因此没有直接对应的spring.*前缀配置属性供配置文件直接使用。

如何实现requestTimeout的配置？ #

有两种常用方式，可根据Spring Boot版本和需求选择：

方式1：自定义HttpServer工厂（通用方式） #

通过创建自定义的ReactorHttpServerFactory Bean，直接配置Netty的requestTimeout：

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.http.server.reactive.ReactorHttpServerFactory;
import reactor.netty.http.server.HttpServer;
import java.time.Duration;

@Configuration
public class NettyTimeoutConfig {

    @Bean
    public ReactorHttpServerFactory reactorHttpServerFactory() {
        return () -> HttpServer.create()
                .requestTimeout(Duration.ofSeconds(30)); // 设置30秒请求超时
    }
}

方式2：使用ReactorNettyServerCustomizer（Spring Boot 2.4+推荐） #

Spring Boot 2.4及以上版本提供了ReactorNettyServerCustomizer接口，可更优雅地定制Netty服务器：

import org.springframework.boot.web.embedded.netty.ReactorNettyServerCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import reactor.netty.http.server.HttpServer;
import java.time.Duration;

@Configuration
public class NettyServerConfig {

    @Bean
    public ReactorNettyServerCustomizer requestTimeoutCustomizer() {
        return httpServer -> httpServer.requestTimeout(Duration.ofSeconds(30));
    }
}

进阶：支持配置文件动态配置 #

如果想通过application.yml或application.properties灵活配置，可结合@ConfigurationProperties实现：

1. 在配置文件中添加自定义配置项：

netty:
  server:
    request-timeout: 30s

2. 编写配置类绑定属性并定制Netty：

import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.boot.web.embedded.netty.ReactorNettyServerCustomizer;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import reactor.netty.http.server.HttpServer;
import java.time.Duration;

@Configuration
@ConfigurationProperties(prefix = "netty.server")
public class NettyServerConfig {

    private Duration requestTimeout = Duration.ofSeconds(15); // 默认超时15秒

    public void setRequestTimeout(Duration requestTimeout) {
        this.requestTimeout = requestTimeout;
    }

    @Bean
    public ReactorNettyServerCustomizer requestTimeoutCustomizer() {
        return httpServer -> httpServer.requestTimeout(requestTimeout);
    }
}

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