SpringCloud:SpringCloudGateway对Forwarded和X-Forwarded-*处理分析
2026/7/23 18:01:14 网站建设 项目流程

一、SpringCloudGateway作为服务器端

1、在接收到包含Forwarded或X-Forwarded-*的HTTP请求头时,会根据部署环境决定是否进行解析

根据部署环境决定是否进行解析的代码可以如下类中找到:

org.springframework.boot.autoconfigure.web.embedded.NettyWebServerFactoryCustomizer

若部署在容器云环境,则默认是要进行解析的,支持的容器云环境对应的环境参数可以在如下类中找到

org.springframework.boot.cloud.CloudPlatform

如果想让它不解析,则配置参数:

server.forwardHeadersStrategy=none

若不部署在容器云,则默认是不进行解析的

如果想让它解析,则配置参数:

server.forwardHeadersStrategy=native

2、Forwarded或X-Forwarded-*的HTTP请求头如何解析定义在如下类中:

reactor.netty.http.server.DefaultHttpForwardedHeaderHandler

它会优先解析Forwarded,若Forwarded不存在才解析X-Forwarded-*,

Forwarded例子如下:

Forwarded:proto=http;host="15.62.25.113:8099";for="15.62.25.117:41668"

X-Forwarded-*例子如下:

X-Forwarded-For:客户端的原始IP地址
X-Forwarded-Host:客户端在原始请求的Host头中指定的原始域名
X-Forwarded-Prefix:在代理转发过程中,URL路径的哪个前缀被剥离了
X-Forwarded-Proto:客户端最初连接到代理或负载均衡器时使用的协议(通常是httphttps

此时如下API就能拿到这两个地址,原始的地址会被替换

ServerHttpRequest.getLocalAddress()
ServerHttpRequest.getRemoteAddress()

此时如下API中返回的URI中的scheme将会替换成proto中的值

ServerHttpRequest.getURI()

二、SpringCloudGateway作为客户端

默认情况下,向外发送HTTP请求会生成Forwarded和X-Forwarded-*的HTTP请求头

生成Forwarded请求头的类如下:

org.springframework.cloud.gateway.filter.headers.ForwardedHeadersFilter

生成X-Forwarded-*请求头的类如下:

org.springframework.cloud.gateway.filter.headers.XForwardedHeadersFilter

以上个类都是在如下类中被调用的:

org.springframework.cloud.gateway.filter.NettyRoutingFilter

若不想生成这些HTTP请求头,可分别配置如下参数进行关闭:

spring.cloud.gateway.forwarded.enabled=false
spring.cloud.gateway.x-forwarded.enabled=false

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询