Spring获取URL信息

背景
原因
解决
- - [Nginx 的 location 里补充标准转发头](#Nginx 的 location 里补充标准转发头)
  - [Spring Boot 配置中启用对转发头的支持](#Spring Boot 配置中启用对转发头的支持)

背景

使用oauth2对接三方统一认证

1、去三方系统登录、成功后回调自己的服务并携带三方认证码code

2、使用认证码获取token、进一步获取人员工号

3、通过工号匹配我方系统人员信息生成token

在第二步、获取token时使用代码获取当前请求的URL、我方Nginx收到了三方的认证回调为https、实际在程序中获取出来的地址是http。导致认证码获取三方系统token异常。

java 复制代码

   private String getDomainName() {
        ServletRequestAttributes attributes = (ServletRequestAttributes) RequestContextHolder.getRequestAttributes();
        HttpServletRequest request = attributes.getRequest();
        return request.getRequestURL().toString();
    }

原因

反向代理终止 TLS：客户端用 HTTPS 访问到 Nginx，Nginx与后端应用用 HTTP 通信。后端若不识别代理头，就会认为"自己收到的是 HTTP"

解决

Nginx 的 location 里补充标准转发头

代理透传"原始请求信息"：Nginx通过 X-Forwarded-* 头把客户端的"原始协议、主机、端口、来源 IP"等信息告诉后端。关键头：

X-Forwarded-Proto ：原始协议，通常为 https 或 http
X-Forwarded-Host ：原始主机名（含域名，可能含端口）
X-Forwarded-Port ：原始端口（如 443 / 80 ）
X-Forwarded-For ：原始客户端 IP 链（逗号分隔）
Host ：把客户端的 Host 头传给后端，避免后端只看到内网目标主机、

bash 复制代码

 proxy_set_header X-Forwarded-Proto $scheme;
 proxy_set_header X-Forwarded-Port  $server_port;
 proxy_set_header X-Forwarded-Host  $host;
 proxy_set_header Host $host;

Spring Boot 配置中启用对转发头的支持

框架"采纳"这些头：应用容器或框架读取这些 X-Forwarded-* （或标准 Forwarded ）头，把 HttpServletRequest 的"可见属性"改成客户端视角，从而 getScheme()/isSecure()/getServerName()/getServerPort()/getRequestURL() 都与外部一致

server.forward-headers-strategy=framework

Spring 注入 ForwardedHeaderFilter ，优先解析标准 Forwarded 头，若没有则解析 X-Forwarded-* 。
过滤器包装 HttpServletRequest ，用头中的值覆盖 scheme / secure / serverName / serverPort 等，使后续代码拿到的是"客户端视角"的请求信息。
受影响的方法包括： request.getScheme() 、 request.isSecure() 、 request.getServerName() 、 request.getServerPort() 、 ServletUriComponentsBuilder 构造的 URL 等。

server.forward-headers-strategy=native

依赖容器原生支持。对于 Tomcat，Spring Boot 会配置 RemoteIpValve ：
- protocolHeader=x-forwarded-proto ：把 X-Forwarded-Proto 采纳为 scheme / secure
- remoteIpHeader=x-forwarded-for ：采纳客户端 IP
- portHeader=x-forwarded-port 、 hostHeader=x-forwarded-host ：采纳端口和主机
Valve在容器层修改请求对象，应用代码"天然"拿到外部视角。

server.use-forward-headers=true （老版本）：

旧属性，作用类似"framework"，在新版本被 server.forward-headers-strategy 取代。