AddRequestHeader 过滤器

DeepSeek V3 中英对照 AddRequestHeader Filter AddRequestHeader Filter

AddRequestHeader 是一个 "before" 过滤器，它接收 name 和 value 参数。以下示例配置了一个 AddRequestHeader 过滤器：

spring:
  cloud:
    gateway:
      mvc:
        routes:
        - id: add_request_header_route
          uri: https://example.org
          filters:
          - AddRequestHeader=X-Request-red, blue

yaml

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.addRequestHeader;
import static org.springframework.cloud.gateway.server.mvc.handler.GatewayRouterFunctions.route;
import static org.springframework.cloud.gateway.server.mvc.handler.HandlerFunctions.http;

@Configuration
class RouteConfiguration {

    @Bean
    public RouterFunction<ServerResponse> gatewayRouterFunctionsAddReqHeader() {
        return route(GET("/red"), http("https://example.org"))
                .before(addRequestHeader("X-Request-red", "blue"));
    }
}

java

此列表为所有匹配的请求在下游请求的头部添加了 X-Request-red:blue 头。

AddRequestHeader 能够识别用于匹配路径或主机的 URI 变量。URI 变量可以在值中使用，并在运行时展开。以下示例配置了一个使用变量的 AddRequestHeader 过滤器：

@Configuration
class RouteConfiguration {

    @Bean
    public RouterFunction<ServerResponse> gatewayRouterFunctionsAddReqHeader() {
        return route(GET("/red/{segment}"), http("https://example.org"))
                .before(addRequestHeader("X-Request-red", "blue-{segment}"));
    }
}

java