proxy_cookie_path 是 nginx 用于重写后端 set-cookie 响应头中 path 属性的指令，解决反向代理下因路径不匹配导致 cookie 丢失、登录态失效问题；需在 location 块中 proxy_pass 后配置，支持字面量替换和正则捕获，仅修改 path 字段，须配合 proxy_redirect、rewrite 等保持路径上下文一致。
proxy_cookie_path 是 Nginx 用于重写后端应用返回的 Set-Cookie 响应头中 Path=... 属性的指令，常用于反向代理场景下解决 Cookie 路径不匹配导致登录态丢失、无法携带 Cookie 等问题。
为什么需要 proxy_cookie_path
当后端服务（比如 Flask、Spring Boot）默认设置 Cookie 路径为 Path=/admin，但你通过 Nginx 代理到 / 或 /app 下时，浏览器只会对匹配路径的请求发送该 Cookie。例如：
- 后端返回：
Set-Cookie: sessionid=abc; Path=/admin; HttpOnly - Nginx 代理访问地址是
https://example.com/→ 浏览器不会在根路径请求中带上这个 Cookie - 结果：用户看似登录了，但后续请求没带 Cookie，后端认为未登录
基本语法与常用写法
指令格式：
proxy_cookie_path path_in_response replacement;
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
它会对所有 Set-Cookie 头中的 Path=xxx 进行正则替换（注意：是字符串替换，不是路径映射）。
-
proxy_cookie_path /admin /;把Path=/admin替换为Path=/ -
proxy_cookie_path /api /;把Path=/api改成Path=/ -
proxy_cookie_path ~^/old/(.*)$ /new/$1;使用正则，把Path=/old/user改成Path=/new/user
配合 location 使用更精准
该指令可出现在 http、server 或 location 块中。推荐在具体 location 中配置，避免影响其他代理：
location /app/ {
proxy_pass https://backend/;
proxy_cookie_path / /app/;
}
说明：
- 后端返回
Path=/→ 被改成Path=/app/ - 这样浏览器只在
/app/xxx请求中才发送该 Cookie，符合代理路径语义
注意事项和常见坑
该指令仅修改 Path= 字段，不影响 Domain、Secure、HttpOnly 等其他属性。
- 如果后端返回多个
Set-Cookie，每条都会被处理 - 替换是“全局字符串替换”，不是前缀匹配。例如
proxy_cookie_path / /foo/会把Path=/user变成Path=/foo/user，也可能误改Path=/api/v1成Path=/foo/api/v1 - 若需精确控制，优先用正则形式，如
proxy_cookie_path ~^/(.*)$ /app/$1;配合^/锚点 - 调试时可用
curl -I查看响应头，或浏览器开发者工具的 Network → Response Headers → Set-Cookie
