proxy_cache_bypass 实现动态缓存绕过需满足三前提：启用 proxy_cache、同 location 块内配置、变量值非空/非0/非off；推荐用 map 预定义布尔变量，配合 proxy_no_cache 防止缓存污染。
要让 Nginx 真正实现“动态调整缓存逻辑”，proxy_cache_bypass 是核心开关，但它不是单独起作用的指令——它必须和 proxy_cache 成对出现，且依赖变量驱动判断逻辑。配置写对了，才能让特定请求跳过缓存查找、直连后端；写错了，等于没配。
必须满足的三个前提条件
缺一不可，否则 proxy_cache_bypass 完全不生效：
- 当前 location 块中已启用缓存：proxy_cache mycache（名称需与 http 块中 proxy_cache_path 的 keys_zone 一致）
- proxy_cache_bypass 指令必须写在同一个 location 块内，不能只放在 server 或 http 块里“全局声明”
- 所用变量必须存在且值符合触发规则：非空字符串、非 "0"、非 "off"、非 ""
变量怎么定义才可靠
直接写 $http_x_refresh 或 $arg_debug 很方便，但复杂场景建议统一用 map 预计算，把路径、Header、Cookie、参数等多源信号收拢成一个布尔变量，比如 $skip_cache：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
- 按路径跳过：map $request_uri $skip_cache_by_path { ~*^/admin/ 1; ~*^/api/debug 1; default 0; }
- 按角色 Header：map $http_x_user_role $skip_cache_by_role { "admin" 1; "dev" 1; default 0; }
- 按 Cookie 登录态：map $cookie_sessionid $skip_cache_by_login { ~. 1; default 0; }
- 最后在 location 中统一调用：proxy_cache_bypass $skip_cache_by_path $skip_cache_by_role $skip_cache_by_login
常见触发方式及写法要点
支持多种客户端标识，灵活组合：
- 自定义请求头（推荐）：客户端发 X-No-Cache: 1，Nginx 写 $http_x_no_cache（注意短横变下划线、全小写）
- URL 参数：如 ?refresh=1 → 对应 $arg_refresh，值为 "1" 即触发
- IP 地址精准匹配：proxy_cache_bypass $remote_addr ~^(192\.168\.5\.100|10\.20\.30\.40)$（必须用 ~^$ 精确匹配）
- 多个条件共存时用空格分隔，任意一个为真即绕过，无需写 if 或逻辑运算符
务必搭配 proxy_no_cache 防止缓存污染
proxy_cache_bypass 只跳过读缓存，不阻止响应写入缓存。调试返回的数据（比如带 debug 字段、未脱敏内容）很可能被错误缓存。所以：
- 同一 location 中加一行：proxy_no_cache $skip_cache_by_path $skip_cache_by_role $skip_cache_by_login
- 这样既跳过读取，又禁止写入，双保险隔离调试流量
- 普通用户请求不受影响，仍走原有缓存策略
