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}