proxy_cookie_path 是 nginx 用于修正反向代理中 cookie path 错配的指令，通过重写后端 set-cookie 响应头的 path 字段，使浏览器能正确存储和发送 cookie；需配合 proxy_cookie_domain、samesite、secure 等设置确保跨域场景下 cookie 可靠生效。
proxy_cookie_path 是 Nginx 在反向代理场景下修复 Cookie 路径错配的关键指令，它不解决跨域本身，而是解决“跨域代理后 Cookie 因 Path 不匹配而被浏览器丢弃”的问题。本质是修正后端 Set-Cookie 响应头中的 Path 属性，让浏览器能正确存储和后续携带。
为什么需要 proxy_cookie_path
当 Nginx 作为反向代理时，后端服务（如 Java Spring Boot 或 Node.js）返回的 Set-Cookie 头中 Path 往往基于其自身路径生成。例如：
- 后端部署在 /Room 路径，返回
Set-Cookie: token=abc; Path=/Room; - 但前端实际访问的是 /api（由 Nginx 代理到 /Room），浏览器收到 Path=/Room 的 Cookie 后，只会在请求
/Room/xxx时自动带上，而不会用于/api/xxx请求 - 结果：Cookie 写入了，但前端发请求时不携带，登录态失效、session 丢失
proxy_cookie_path 的作用原理
该指令在 Nginx 将后端响应转发给客户端前，重写 Set-Cookie 头中的 Path 字段。语法为：
proxy_cookie_path 旧路径 新路径;常见用法：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
-
proxy_cookie_path /Room /;→ 把 Path=/Room 替换为 Path=/ -
proxy_cookie_path /api /;→ 若后端返回 Path=/api，则统一改为根路径 - 支持正则：如
proxy_cookie_path ~^/v1/(.*)$ /$1;，灵活映射子路径
配合其他 Cookie 属性才能真正生效
仅改 Path 不够，尤其在 iframe 或 HTTPS 生产环境，还需同步处理：
-
SameSite 和 Secure：Chrome 80+ 要求跨站 Cookie 必须显式声明
SameSite=None; Secure；若后端未设置，可在 Nginx 中补全：proxy_cookie_path / "/; SameSite=None; Secure"; -
Domain 一致性：若前后端域名不同（如 a.com 代理 b.com），需加
proxy_cookie_domain b.com a.com;，否则浏览器因 domain 不匹配拒绝保存 -
HttpOnly 安全性保留：重写时注意不要覆盖 HttpOnly 标志，推荐完整拼接：
proxy_cookie_path / "/; Path=/; HttpOnly; SameSite=None; Secure";
典型配置示例
假设前端访问 https://app.example.com/api/xxx，Nginx 代理到后端 http://192.168.0.118:8087/Room/xxx，且后端返回 Cookie 的 Path 为 /Room：
location /api/ {
proxy_pass http://192.168.0.118:8087/Room/;
proxy_cookie_path /Room /;
proxy_cookie_domain ~\.example\.com$ example.com;
proxy_set_header X-Forwarded-Proto $scheme;
}
这样，后端返回的 Path=/Room 被转为 Path=/，domain 也统一为 example.com，配合前端 axios 设置 withCredentials: true，Cookie 即可稳定写入并随请求携带。
