Nginx 中 proxy_cache_bypass 动态调整缓存逻辑-Nginx-PHP中文网

proxy_cache_bypass 实现动态缓存绕过需满足三前提：启用 proxy_cache、同 location 块内配置、变量值非空/非0/非off；推荐用 map 预定义布尔变量，配合 proxy_no_cache 防止缓存污染。

nginx 中 proxy_cache_bypass 动态调整缓存逻辑

要让 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 或逻辑运算符