proxy_cookie_path 是 nginx 用于重写后端 set-cookie 中 path 属性的指令，解决多路径部署下因 cookie 路径不匹配导致的登录态丢失问题；它按正则匹配并替换 path 值，需在 location 块中配置，仅作用于 path 字段，末尾斜杠须严格匹配。
proxy_cookie_path 是 Nginx 反向代理中用于重写后端 Set-Cookie 响应头中 Path 属性的关键指令，它能自动将后端应用返回的 Cookie 路径映射为前端统一访问路径，从而解决多路径部署下 Session Cookie 作用域不匹配导致的登录态丢失问题。
为什么需要 proxy_cookie_path？
当后端服务部署在子路径（如 /app1/、/app2/）下，且自身生成的 Session Cookie 指定了 Path=/app1/，而用户通过 Nginx 统一入口（如 https://example.com/）访问时，浏览器只会对 /app1/ 下的请求发送该 Cookie。若 Nginx 将请求代理到后端但未修改 Cookie 路径，用户访问根路径或其它子路径时就无法携带有效 Session，导致反复登录或权限异常。
基本语法与替换逻辑
proxy_cookie_path 按正则匹配并替换 Set-Cookie 中的 Path 值，格式为：
其中：
- pattern 是匹配原始 Path 值的正则表达式（支持捕获组）
-
replacement 是替换后的路径，可引用捕获组（如
$1） - 匹配失败时保持原 Path 不变；匹配成功则覆盖原有 Path
例如后端返回：Set-Cookie: JSESSIONID=abc123; Path=/app1/; HttpOnly，可通过以下指令将其 Path 改为 /：
多路径场景下的动态映射策略
若同一 Nginx 配置需代理多个后端路径（如 /admin/ → 后端 /，/api/ → 后端 /v1/），需按 location 分别设置，确保 Cookie 路径与前端可见路径一致：
- 对
location /admin/：后端返回Path=/，应映射为Path=/admin/，避免 Cookie 泄露到其它路径 - 对
location /api/：后端返回Path=/v1/，可映射为Path=/api/，使浏览器仅在/api/请求中发送该 Cookie - 使用正则捕获可提升复用性，例如：
proxy_cookie_path ~^/(.*)$ /api/$1;（慎用，需确认后端 Path 格式）
典型配置示例：
location /admin/ {proxy_pass https://backend-admin/;
proxy_cookie_path / /admin/;
}
location /api/ {
proxy_pass https://backend-api/v1/;
proxy_cookie_path /v1/ /api/;
}
注意事项与常见陷阱
该指令仅处理 Set-Cookie 的 Path 字段，不影响 Domain、Secure 或 HttpOnly 等其他属性。实际使用中需注意：
- 必须在
proxy_pass所在的 location 块中配置，全局或 server 块中无效 - 若后端返回多个 Set-Cookie，该指令会逐个处理每个响应头中的 Path
- 路径末尾斜杠需严格匹配：写
/app1不匹配Path=/app1/，应写/app1/或使用正则~^/app1/ - 当后端使用相对路径（如
Path=.）或未设 Path 时，浏览器默认使用当前响应路径，此时更推荐在后端规范设置 Path，而非依赖 Nginx 修补
