Nginx代理Java应用时跨域头丢失，需显式透传Origin等请求头、用add_header always补全响应头、拦截302重定向加CORS头并修正Location，同时Java应动态生成跳转地址。
Java 应用（如 Spring Boot）部署在 Nginx 后，跨域请求在代理过程中出现头丢失，本质不是 Java 本身的问题，而是 Nginx 默认转发策略与 Java 服务协同不当所致。关键在于：Nginx 不自动透传 Origin、自定义头（如 Authorization、X-Request-ID），也不默认转发 Access-Control-* 响应头；而 Java 服务若依赖原始 Origin 做动态校验或生成跳转地址，就会因收不到头而失效。
确保 Origin 和关键请求头完整透传到 Java 后端
Nginx 默认只转发少量标准头（Host、User-Agent 等），Origin 和带下划线的自定义头（如 x_api_key）需显式声明才能抵达 Java 服务：
- 在 server 或 http 块顶部开启下划线支持：underscores_in_headers on;（否则 gray_token、user_id 等含 _ 的头会被静默丢弃）
- 在 location 块中逐个透传所需头：
proxy_set_header Origin $http_origin;
proxy_set_header Authorization $http_authorization;
proxy_set_header X-Request-ID $http_x_request_id; - 确认 proxy_pass_request_headers on; 已启用（虽默认为 on，显式写出更稳妥）
解决 proxy_pass 后响应头被“吃掉”的问题
Java 后端已返回 Access-Control-Allow-Origin 等头，但浏览器仍报错，大概率是 Nginx 拦截并丢弃了这些响应头。必须在 location 中用 add_header ... always 显式补全：
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- 添加基础跨域响应头（always 参数不可省略）：
add_header 'Access-Control-Allow-Origin' '$http_origin' always;
add_header 'Access-Control-Allow-Credentials' 'true' always;
add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, PUT, DELETE' always;
add_header 'Access-Control-Allow-Headers' 'Content-Type, Authorization, X-Requested-With' always; - 避免后端重复输出 CORS 头——Spring Boot 中禁用 @CrossOrigin 或 WebMvcConfigurer 的全局配置，统一由 Nginx 控制，防止头冲突或被覆盖
应对 Java 返回 302 重定向时的跨域断裂
Java 登录成功返回 302 跳转到 /dashboard，浏览器发起新请求，但该请求不带 Origin，且目标地址未配 CORS，导致跳转后白屏或报错。这不是头丢失，而是浏览器对每步重定向独立校验 CORS：
- 在 Nginx 中拦截 302：
proxy_intercept_errors on;
error_page 301 302 = @handle_redirect; - 在命名 location 中重写跳转并加头：
@handle_redirect {
add_header 'Access-Control-Allow-Origin' '$http_origin' always;
add_header 'Access-Control-Allow-Credentials' 'true' always;
return 302 $sent_http_location;
} - 同步修正 Location 地址（如将 http://127.0.0.1:8080/ 改为 https://yourdomain.com/）：
proxy_redirect ~^http://[^/]+(?::\d+)?/(.*)$ https://$host/$1;
让 Java 正确生成跳转 URL（治本之策）
Java 服务不应硬编码跳转地址（如 "http://localhost:8080/dashboard"），而应读取 Nginx 透传的代理头，动态构造：
- Nginx 配置中透传协议和原始 Host：
proxy_set_header X-Forwarded-Proto $scheme;
proxy_set_header Host $http_host; - Spring Boot 中启用 ForwardHeaderFilter（或配置 server.forward-headers-strategy=framework），使 HttpServletRequest.getScheme()、getServerName() 返回真实外网值
- 登录逻辑中用 response.sendRedirect(request.getRequestURL().toString().replace("/login", "/dashboard")) 类方式拼接，而非写死内网地址
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
