RewriteLocationResponseHeader GatewayFilter 工厂

DeepSeek V3 中英对照 RewriteLocationResponseHeader GatewayFilter Factory RewriteLocationResponseHeader GatewayFilter Factory

RewriteLocationResponseHeader GatewayFilter 工厂用于修改 Location 响应头的值，通常用于移除后端特定的细节信息。它接受 Mode、locationHeaderName、hostValue 和 protocols 参数。以下配置示例展示了如何配置 RewriteLocationResponseHeader GatewayFilter：

spring:
  cloud:
    gateway:
      routes:
      - id: rewritelocationresponseheader_route
        uri: http://example.org
        filters:
        - RewriteLocationResponseHeader=AS_IN_REQUEST, Location, ,

例如，对于 POST [api.example.com/some/object/name](https://api.example.com/some/object/name) 的请求，Location 响应头值 [object-service.prod.example.net/v2/some/object/id](https://object-service.prod.example.net/v2/some/object/id) 会被重写为 [api.example.com/some/object/id](https://api.example.com/some/object/id)。

Mode 参数有以下可能的值：NEVER_STRIP、AS_IN_REQUEST（默认值）和 ALWAYS_STRIP。

• NEVER_STRIP: 即使原始请求路径不包含版本，也不会剥离版本。

• AS_IN_REQUEST: 仅当原始请求路径不包含版本时，才会剥离版本。

• ALWAYS_STRIP: 即使原始请求路径包含版本，也始终会剥离版本。

如果提供了 hostValue 参数，它将用于替换响应 Location 头中的 host:port 部分。如果未提供，则使用 Host 请求头的值。

protocols 参数必须是一个有效的正则表达式 String，协议名称将与之进行匹配。如果未匹配，过滤器将不执行任何操作。默认值为 https?|ftps?。