Spring Cloud Gateway配置长超时后上传大文件仍30秒超时咨询

1 优先排查负载均衡组件超时（最高概率） #

如果你的路由uri配置为lb://开头的服务发现地址，Ribbon或Spring Cloud LoadBalancer的默认读超时为30秒，会优先于Gateway的HTTP客户端超时触发，你当前配置的Gateway层级超时不会生效，需要新增对应配置：

• 如果你使用Ribbon作为负载均衡组件，新增配置：

ribbon:
  ConnectTimeout: 600000
  ReadTimeout: 600000

• 如果你使用Spring Cloud LoadBalancer作为负载均衡组件，新增配置：

spring:
  cloud:
    loadbalancer:
      connect-timeout: 600000
      read-timeout: 600000

2 修正Resilience4J熔断实例配置 #

你当前仅配置了熔断的默认全局规则，但全局过滤器中指定了name: global-fallback的独立熔断实例，默认规则不会自动应用到该命名实例，需要补充该实例的TimeLimiter配置：

public Customizer<ReactiveResilience4JCircuitBreakerFactory> defaultCustomizer() {
    return factory -> {
        // 覆盖指定熔断实例的配置
        factory.configure(builder -> builder
                .timeLimiterConfig(TimeLimiterConfig.custom().timeoutDuration(Duration.ofMillis(600000)).build())
                .circuitBreakerConfig(CircuitBreakerConfig.ofDefaults())
        , "global-fallback");
        // 保留原有默认配置
        factory.configureDefault(id -> new Resilience4JConfigBuilder(id)
                .circuitBreakerConfig(CircuitBreakerConfig.ofDefaults())
                .timeLimiterConfig(TimeLimiterConfig.custom().timeoutDuration(Duration.ofMillis(600000)).build())
                .build());
    };
}

3 移除不必要的CachingRequestBody过滤器 #

大文件上传场景不需要缓存请求体，CachingRequestBody过滤器会将完整的250MB请求体缓存到内存/磁盘后再转发，不仅会大幅增加请求耗时，还容易触发内存溢出、缓冲区超时等问题，直接删除该过滤器配置，使用Gateway原生的流式转发即可。

4 补充WebFlux编解码缓冲区配置 #

Spring WebFlux默认的内存缓冲区上限为256KB，超过该大小的请求体处理会抛出异常，需要补充配置匹配你设置的文件大小上限：

spring:
  codec:
    max-in-memory-size: 1024MB

5 补充Netty HttpClient空闲超时配置 #

你当前仅配置了连接和响应超时，Netty默认的空闲连接超时为30秒，大文件上传过程中如果出现短时读写空闲会被主动断开，新增配置：

spring:
  cloud:
    gateway:
      httpclient:
        idle-timeout: 700000

6 快速验证方式 #

可以先临时注释全局OrderedCircuitBreaker过滤器配置，直接测试上传接口，如果不再触发30秒超时，即可定位问题为熔断配置问题；如果仍然超时，优先排查负载均衡和Netty配置。

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