最新の安定バージョンについては、Spring Cloud Gateway 5.0.1 を使用してください！

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 の 2 つのヘッダーを追加します。これは AddRequestHeader の動作と似ていますが、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}