如何利用 proxy_cookie_path 解决路径重写后的后端 Cookie 丢失难题-Nginx-PHP中文网

用 proxy_cookie_path 解决 Cookie 丢失，关键是使浏览器看到的 Cookie Path 匹配实际访问路径；需在 location 块中紧接 proxy_pass 配置，支持字面量和正则匹配，并配合 proxy_redirect、rewrite 等指令统一路径上下文。

如何利用 proxy_cookie_path 解决路径重写后的后端 cookie 丢失难题

用 proxy_cookie_path 解决路径重写后 Cookie 丢失，关键是让浏览器看到的 Cookie Path 值匹配用户实际访问的 URL 路径。后端按自身部署路径（如 / 或 /api）设 Path，但 Nginx 把 /myapp/ 代理过去后，浏览器发现当前地址是 /myapp/login，而 Cookie 的 Path 是 /api，不构成前缀关系，直接丢弃——登录态、Session 全失效。

确认问题根源：看浏览器里存了什么 Path

打开开发者工具 → Application → Cookies，检查目标 Cookie 的 Path 字段。再对比你正在访问的页面 URL 路径（比如 https://example.com/myapp/dashboard）。如果后者不是前者的前缀，就是它导致 Cookie 不发送。

常见错误路径组合：Path=/ 对应访问 /myapp/；Path=/admin 对应访问 /myapp/api
注意：这个匹配是严格前缀判断，/admin 不匹配 /myapp/admin，除非你主动重写

正确配置 proxy_cookie_path：位置、顺序、写法三要素

该指令只在响应返回客户端前修改 Set-Cookie 头里的 Path= 部分，必须满足三个条件才生效：

写在 location 块内，且与 proxy_pass 在同一作用域
紧接在 proxy_pass 下一行，不能前置也不能跨块
source 匹配的是后端响应头中完整的 Path=xxx 值，不是请求路径

例如，后端返回 Set-Cookie: sid=abc; Path=/，你想让它变成 Path=/myapp/：

location /myapp/ {
    proxy_pass http://backend/;
    proxy_cookie_path / "/myapp/";
}

应对不同后端路径习惯的常用写法

后端路径风格各异，proxy_cookie_path 支持字面量和正则两种匹配方式：

Bailian Usage Proxy

阿里百炼大模型平台多人共享账号用量统计代理服务。解决公司共用账号时无法区分个人用量的问题。适用场景：1)部署用量统计代理；2)统计多人Token用量和调用次数；3)管理大模型API调用配额。

下载

后端统一设 Path=/ → proxy_cookie_path / "/myapp/";
后端设 Path=/api/v1/，代理到 /myapp/api/v1/ → proxy_cookie_path /api/v1/ "/myapp/api/v1/";
后端路径带可变前缀（如 /v1/、/v2/），想统一收口 → proxy_cookie_path ~^/(v\d+)/(.*)$ "/myapp/$1/$2";