WebFlux无内容时60秒超时：如何实现客户端按需等待响应？

你遇到的是WebFlux底层容器（默认Netty）的空闲超时限制，默认60秒无读写操作就会中止连接。可以通过以下几种方式按需调整等待时长：

• 全局调整Netty连接空闲超时
  Spring Boot中，Netty默认的连接空闲超时为60秒，直接修改配置即可覆盖：

  # 示例：设置为1小时，单位支持s(秒)、m(分)、h(时)
  server.netty.idle-timeout=3600s
  

  YAML格式：

  server:
    netty:
      idle-timeout: 3600s
  

  这个配置会作用于所有HTTP连接，只要连接有读写操作就会重置超时计时器。

• 针对特定接口设置响应超时
  如果需要给不同接口配置不同的超时规则，可以通过WebFilter或路由定义实现：

  1. 全局过滤器方式（批量处理）：

  @Configuration
  public class CustomWebFluxConfig {
      @Bean
      public WebFilter timeoutFilter() {
          return (exchange, chain) -> {
              // 按需设置超时时长，比如5分钟
              Duration customTimeout = Duration.ofMinutes(5);
              return chain.filter(exchange)
                      .timeout(customTimeout)
                      .onErrorResume(TimeoutException.class, e -> {
                          exchange.getResponse().setStatusCode(HttpStatus.REQUEST_TIMEOUT);
                          return exchange.getResponse().setComplete();
                      });
          };
      }
  }
  

  2. 单个路由配置方式：

  @Bean
  public RouterFunction<ServerResponse> dataStreamRoute() {
      return RouterFunctions.route(RequestPredicates.GET("/data/stream"), request ->
              ServerResponse.ok()
                      .contentType(MediaType.TEXT_EVENT_STREAM)
                      .body(yourFluxDataSource(), String.class)
                      .timeout(Duration.ofHours(1)) // 给该接口单独设置1小时超时
      );
  }
  

• 额外优化建议

  • 避免设置无限超时，否则会导致服务器连接资源被长期占用，建议根据业务场景设置合理的最大值。
  • 若客户端（如浏览器、第三方HttpClient）自身也有超时限制，需要同步调整客户端的超时配置，否则客户端可能先主动断开连接。
  • 对于长时间无数据输出的场景，可以定期发送心跳包（比如空换行符或特定心跳标识），通过持续的小流量操作重置超时计时器，维持连接存活。

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