SetRequestHeader 过滤器

DeepSeek V3 中英对照 SetRequestHeader Filter SetRequestHeader Filter

SetRequestHeader 过滤器接受 name 和 value 参数。以下清单配置了一个 SetRequestHeader 过滤器：

spring:
  cloud:
    gateway:
      mvc:
        routes:
        - id: setrequestheader_route
          uri: https://example.org
          filters:
          - SetRequestHeader=X-Request-Red, Blue

yaml

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.setRequestHostHeader;
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> gatewayRouterFunctionsSetRequestHeader() {
		return route("add_request_parameter_route")
				.GET("/**", http("https://example.org"))
					.before(setRequestHostHeader("X-Request-Red", "Blue"))
					.build();
    }
}

java

此过滤器会替换（而不是添加）所有具有给定名称的标头。因此，如果下游服务器响应了 X-Request-Red:1234，它将被替换为 X-Request-Red:Blue，这是下游服务将接收到的内容。

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

spring:
  cloud:
    gateway:
      routes:
      - id: setrequestheader_route
        uri: https://example.org
        predicates:
        - Host: {segment}.myhost.org
        filters:
        - SetRequestHeader=X-Request-Red, Blue-{segment}

yaml

import static org.springframework.cloud.gateway.server.mvc.filter.BeforeFilterFunctions.setRequestHostHeader;
import static org.springframework.cloud.gateway.server.mvc.handler.GatewayRouterFunctions.route;
import static org.springframework.cloud.gateway.server.mvc.handler.HandlerFunctions.http;
import static import static org.springframework.cloud.gateway.server.mvc.predicate.GatewayRequestPredicates.host;

@Configuration
class RouteConfiguration {

    @Bean
    public RouterFunction<ServerResponse> gatewayRouterFunctionsSetRequestHeader() {
		return route("add_request_parameter_route")
				.route(host("{segment}.myhost.org"), http("https://example.org"))
					.before(setRequestHostHeader("X-Request-Red", "Blue-{segment}"))
					.build();
    }
}

java