仅配置 proxy_no_cache 无法真正绕过缓存，必须与 proxy_cache_bypass 配合使用；推荐用 map 统一生成布尔变量（如登录态、角色、调试参数），在 location 中同时设置两个指令，并添加响应头验证效果。

仅配置 proxy_no_cache 无法真正绕过缓存读取，必须和 proxy_cache_bypass 配合使用，二者变量一致、逻辑互补，才能实现“不查缓存 + 不存响应”的完整旁路。

用 map 提前算出要不要绕过

直接在 proxy_no_cache 里写条件不可靠，也难维护。推荐统一用 map 指令把各种请求特征转成布尔变量：

• 检测登录态：用 map $cookie_sessionid $no_cache_by_login { ~. 1; default 0; } —— 只要 sessionid 存在就标记为需绕过
• 识别高权限用户：用 map $http_x_user_role $no_cache_by_role { "admin" 1; "dev" 1; default 0; }
• 匹配调试参数：用 map $args $no_cache_by_arg { ~debug=1 1; ~v=[^&]+ 1; default 0; } —— 支持 ?a=1&debug=1 或 ?v=2.3 这类任意位置的参数
• 所有 map 的 default 必须是 0，否则未命中规则的普通请求也会被误拦截

location 中同时启用读写双绕过

在对应 location 块里，把上面生成的变量一起传给两个指令：

FastAPI Flask Proxy

FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。

下载

• proxy_cache_bypass $no_cache_by_login $no_cache_by_role $no_cache_by_arg; —— 任一为真，就跳过缓存查找，直连后端
• proxy_no_cache $no_cache_by_login $no_cache_by_role $no_cache_by_arg; —— 同样条件成立时，禁止把本次响应写入缓存
• 两个指令必须写在同一 location，且该 location 已启用 proxy_cache my_cache;，否则无效

避免误伤静态资源和匿名流量

个性化策略不能影响首页、图片、JS/CSS 等公共资源：

• 对 /static/、/images/、/assets/ 这类路径单独写 location，跳过上述 map 判断，只配 proxy_cache_valid 和 expires
• 不要在 http 块全局写 proxy_no_cache $cookie_sessionid，空 cookie 会被当非空处理，导致大量 MISS
• 如果业务有灰度头（如 X-Env: staging），也可用 map 提取，和登录态变量并列使用，保持扩展性

加响应头快速验证是否生效

调试阶段加上这两行，用 curl 就能一眼看出行为：

• add_header X-Cache-Status "$upstream_cache_status" always; —— 返回 HIT / MISS / BYP
• add_header X-No-Cache-Reason "$no_cache_by_login|$no_cache_by_role|$no_cache_by_arg" always; —— 显示哪个变量触发了绕过
• 发起带 sessionid 或 ?debug=1 的请求，响应头中 X-Cache-Status 应为 BYP，且 X-No-Cache-Reason 至少有一个值是 1