AddRequestHeadersIfNotPresent GatewayFilter 工厂

AddRequestHeadersIfNotPresent GatewayFilter 工厂接受由冒号分隔的 name 和 value 对的集合。以下示例配置了一个 AddRequestHeadersIfNotPresent GatewayFilter

application.yml
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

此配置列表为所有匹配的下游请求头添加了两个头：X-Request-Color-1:blue 和 X-Request-Color-2:green。这与 AddRequestHeader 的工作方式类似，但不同之处在于，它只会在请求头不存在时添加。否则，将发送客户端请求中的原始值。

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

AddRequestHeadersIfNotPresent 还支持用于匹配路径或主机的 URI 变量。URI 变量可以在值中使用，并在运行时展开。以下示例配置了一个使用变量的 AddRequestHeadersIfNotPresent GatewayFilter

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