AddRequestHeadersIfNotPresent GatewayFilter 工厂

AddRequestHeadersIfNotPresent GatewayFilter 工厂接受一组以冒号分隔的 name（名称）和 value（值）对。

以下示例配置了一个 AddRequestHeadersIfNotPresent GatewayFilter：

application.yml

yaml

spring:
  cloud:
    gateway:
      routes:
      - id: add_request_headers_route
        uri: https://example.org
        filters:
        - AddRequestHeadersIfNotPresent=X-Request-Color-1:blue,X-Request-Color-2:green

此配置会为所有匹配的请求向下游请求的 Header 中添加两个头信息：X-Request-Color-1:blue 和 X-Request-Color-2:green。

这与 AddRequestHeader 的工作方式类似，但不同之处在于：仅当 Header 尚未存在时，它才会添加。如果客户端请求中已经包含了该 Header，则会发送原始值（不会覆盖）。

此外，要设置多值 Header，请多次使用相同的 Header 名称，例如 AddRequestHeadersIfNotPresent=X-Request-Color-1:blue,X-Request-Color-1:green。

AddRequestHeadersIfNotPresent 也支持用于匹配路径或主机的 URI 变量。URI 变量可以在 value 中使用，并在运行时进行扩展。

以下示例配置了一个使用变量的 AddRequestHeadersIfNotPresent GatewayFilter：

application.yml

yaml

spring:
  cloud:
    gateway:
      routes:
      - id: add_request_header_route
        uri: https://example.org
        predicates:
        - Path=/red/{segment}
        filters:
        - AddRequestHeadersIfNotPresent=X-Request-Red:Blue-{segment}

AddRequestHeadersIfNotPresent GatewayFilter 工厂 ​

AddRequestHeadersIfNotPresent GatewayFilter 工厂