必须配置 proxy_cookie_domain 才能解决反向代理下 cookie domain 不匹配导致的登录态失效问题，因其可重写后端返回的 set-cookie 中 domain 字段以适配前端访问域名。
当后端服务返回的 Cookie 中 Domain 属性与前端访问域名不匹配时，浏览器会直接丢弃该 Cookie，导致登录态失效、Session 丢失等问题。Nginx 作为反向代理，在转发响应时默认不会修改 Set-Cookie 头中的 Domain 字段，必须显式配置 proxy_cookie_domain 才能重写它。
为什么需要 proxy_cookie_domain
比如后端应用（如 Spring Boot）部署在 api.example.com:8080，它设的 Cookie Domain 是 api.example.com；而用户实际通过 Nginx 访问的是 www.example.com。浏览器认为 www.example.com 与 api.example.com 不同源，拒绝存储该 Cookie。此时需让 Nginx 把响应头中 Set-Cookie: user=abc; Domain=api.example.com 改成 Domain=www.example.com 或直接去掉 Domain 字段。
基本语法与常用写法
proxy_cookie_domain 指令作用于 location 或 server 块内，格式为：
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
proxy_cookie_domain off;：关闭自动重写（默认行为） -
proxy_cookie_domain old-domain new-domain;：将旧 Domain 替换为新 Domain -
proxy_cookie_domain ~\.example\.com$ www.example.com;：支持正则匹配，更安全灵活 -
proxy_cookie_domain $host $host;：动态使用当前 host，适合多租户或泛域名场景
典型配置示例
假设用户访问 https://app.mycompany.com，Nginx 代理到后端 http://127.0.0.1:3000，而后端返回的 Cookie 带有 Domain=mycompany.com 或 Domain=backend.mycompany.com：
location /api/ {
proxy_pass http://127.0.0.1:3000/;
proxy_cookie_domain ~\.(mycompany\.com|backend\.mycompany\.com)$ app.mycompany.com;
proxy_cookie_path / /api/;
}
说明：
- 正则
~\.(mycompany\.com|backend\.mycompany\.com)$匹配所有以这两个域结尾的 Domain 值 - 替换为
app.mycompany.com，确保浏览器接受并携带该 Cookie - 搭配
proxy_cookie_path同步修正路径，避免因路径不匹配导致 Cookie 不发送
配合其他关键指令使用
单靠 proxy_cookie_domain 不足以解决全部 Cookie 问题，还需注意：
-
proxy_set_header Host $host;：确保后端收到正确的 Host，影响其生成的跳转链接和 Cookie Domain 判断 -
proxy_pass_request_headers on;（默认开启）：保证请求头正常透传 -
proxy_redirect off;：防止 Nginx 自动重写 Location 头时破坏跳转逻辑 - 若后端使用 HTTPS 且启用了
Secure标志，Nginx 需配置proxy_set_header X-Forwarded-Proto $scheme;，否则 Secure Cookie 在 HTTP 代理下可能被拒绝
前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！
