使用 proxy_cookie_path 修改后端返回的 Cookie Path 为用户实际访问路径，可解决因路径不匹配导致的 Cookie 丢失问题；需在 location 块中紧接 proxy_pass 配置，并配合 proxy_redirect、rewrite 和 X-Forwarded-Prefix 等确保路径一致性。
直接用 proxy_cookie_path 把后端返回的 Cookie Path 改成和用户实际访问路径一致，就能解决因路径不匹配导致的 Cookie 丢失问题。关键不是“加功能”，而是让浏览器觉得“这个 Cookie 确实该发给我”。
为什么 Cookie 会丢
后端应用不知道你在用 Nginx 做代理，它按自己看到的路径设 Cookie。比如：
- 你访问
https://example.com/myapp/login - Nginx 把请求转给
http://localhost:8000/login（用了proxy_pass http://localhost:8000/;） - 后端返回
Set-Cookie: session=abc; Path=/ - 浏览器一看：当前 URL 路径是
/myapp/...，而 Cookie 的 Path 是/—— 虽然/理论上能覆盖所有路径，但很多现代浏览器（尤其启用了 SameSite 严格策略时）会拒绝发送；更常见的是后端设了Path=/api，而你访问的是/myapp/，/api并非/myapp/的前缀，直接丢弃
怎么配 proxy_cookie_path
指令必须写在 location 块里，且紧接在 proxy_pass 后面。常见写法有三种：
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 后端返回
Path=/，你代理到/myapp/→ 写proxy_cookie_path / "/myapp/"; - 后端返回
Path=/admin，你想让它变成/myapp/admin→ 写proxy_cookie_path /admin "/myapp/admin"; - 后端路径多变（比如
/v1/user、/v2/order），想统一映射到/myapp/下 → 用正则：proxy_cookie_path ~^/(.*)$ "/myapp/$1";（注意：要确保$1不为空，否则可能生成/myapp//）
光改 Cookie 还不够
Cookie 的 Path 只影响“浏览器要不要发”，但整个代理链路还有其他地方会出错：
-
跳转地址错乱：后端返回
Location: /dashboard，用户却在/myapp/下，得加proxy_redirect /dashboard /myapp/dashboard;或批量重写proxy_redirect / /myapp/; -
请求路径没对齐：客户端请求
/myapp/api/user，要让后端收到/api/user，得加rewrite ^/myapp/(.*)$ /$1 break; -
后端生成链接依赖上下文：加上
proxy_set_header X-Forwarded-Prefix /myapp;，方便后端拼资源路径或 API 地址
容易踩的坑
配置生效有硬性要求：
- 不能写在
server块顶层，也不能写在另一个不匹配的location里 - 不能写在
proxy_pass前面——顺序错了就不生效 -
proxy_pass尾部斜杠很重要：http://backend/;表示剥离前缀，后端通常返回Path=/；http://backend;表示保留前缀，后端可能返回Path=/myapp/，这时只需微调甚至不用改 -
proxy_cookie_path只改响应头里的Set-Cookie: Path=，不碰请求头里的 Cookie，也不处理缓存体内容——缓存命中时返回的仍是已被重写过的 Cookie，所以不用额外担心缓存污染
