Nginx与Spring Boot必须协同配置才能正确识别HTTPS协议：Nginx需透传X-Forwarded-Proto等头，Spring Boot需启用forward-headers-strategy=framework或use-forward-headers=true并指定protocol-header，否则后端仍误判为HTTP。
关键不是只加一行 header，而是 Nginx 和 Spring Boot 两端必须协同生效：Nginx 正确透传协议，Spring Boot 主动信任并解析它。
1. Nginx 必须透传真实 Scheme
在 location 或 server 块中，紧挨着 proxy_pass 之前 添加：
-
proxy_set_header X-Forwarded-Proto $scheme;—— 用内置变量，不硬编码 https - 配套加上
proxy_set_header Host $host;和proxy_set_header X-Forwarded-Host $host;，避免域名错乱 - 如果前端用了非标端口（如 8443），建议加
proxy_set_header X-Forwarded-Port $server_port;
2. Spring Boot 必须启用并配置头解析
仅靠 Nginx 设置无效，Spring Boot 默认忽略 X-Forwarded-Proto。需明确启用转发头支持：
SpringBoot升级-BW
下载
将 Spring Boot 2.7 项目升级到 Spring Boot 3.5 的实战流程，覆盖版本基线、依赖坐标替换、Jakarta 迁移、配置兼容、异步上下文传递改造与验证门禁。用于企业多模块 Maven 项目升级与排障。
- 推荐方式（Spring Boot 2.6+）：
server.forward-headers-strategy=framework - 兼容旧版或细粒度控制：
server.use-forward-headers=trueserver.tomcat.remote-ip-header=X-Forwarded-Forserver.tomcat.protocol-header=X-Forwarded-Proto - 若使用独立 Tomcat，还需在
server.xml的<Valve>中启用RemoteIpValve
3. 验证是否真正生效
别只看配置有没有写，要验证请求链路是否贯通：
- 用 curl 模拟请求：
curl -I http://your-domain/，检查响应头中重定向 URL 是否为 https - 在 Controller 中打印：
request.getScheme()和request.isSecure()，确认返回https和true - 查看浏览器 Network 面板，检查 Cookie 的
Secure属性、API 返回的绝对链接协议是否正确
4. 常见陷阱与规避
很多问题其实源于“半配置”：
- 写了
X-Forwarded-Proto却没开 Spring Boot 的转发头支持 → 后端仍读原始连接协议 - 硬编码
proxy_set_header X-Forwarded-Proto https;→ HTTP 访问时强制标记为 HTTPS，引发跳转死循环 - 漏传
Host头 → 后端构建 URL 时用错域名，或直接返回 400 - 多层代理（如 CDN + Nginx）未配置可信网段 →
RemoteIpValve无法安全剥离中间 IP
