Nginx中让特定请求绕过缓存需同时满足三前提：同一location启用proxy_cache、变量命名规范（如$http_x_bypass_cache）、变量值非空且不为"0"/"off"；必须配合proxy_no_cache共用同一变量，形成读写双绕过，并通过X-Cache-Status:BYP及$upstream_cache_status=BYP验证生效。
要在 Nginx 中让特定请求绕过缓存、直连后端，关键不是“禁用缓存”，而是用 proxy_cache_bypass 主动跳过缓存查找环节——它必须和 proxy_cache 在同一个 location 块中启用，且需配合 proxy_no_cache 防止响应被意外缓存。
必须满足的三个前提条件
缺一不可，否则配置无效：
-
同一 location 内启用缓存：必须有
proxy_cache mycache;（名称需与proxy_cache_path中的keys_zone一致） -
变量命名严格规范：比如请求头
X-Bypass-Cache对应变量是$http_x_bypass_cache（短横变下划线、全小写） -
变量值触发规则明确：只要变量值非空、且不等于
"0"或"off"，就立即 bypass；空值或缺失则走正常缓存流程
常用触发方式及对应配置
根据实际使用场景选择一种或组合使用：
-
用自定义请求头识别开发请求：
proxy_cache_bypass $http_x_bypass_cache;
前端或 curl 加-H "X-Bypass-Cache: 1"即可生效 -
用查询参数快速验证：
proxy_cache_bypass $arg_nocache;
访问/api/data?nocache=1就跳过缓存 -
用 Cookie 区分内部人员：
proxy_cache_bypass $cookie_dev_mode;
登录态中设置dev_mode=1的 Cookie 即触发 -
按管理接口路径排除（需先用 map）：
在 http 块中定义：map $request_uri $skip_admin_route { ~*^/admin/ 1; default 0; }
再在 location 中写：proxy_cache_bypass $skip_admin_route;
务必同步配置 proxy_no_cache
只配 proxy_cache_bypass 是不安全的：它只跳过读缓存，但响应仍可能被写入缓存。尤其管理员请求返回用户列表、token 等敏感内容时，会造成越权泄露。
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
正确做法是两者共用同一变量：
proxy_cache_bypass $http_x_bypass_cache;proxy_no_cache $http_x_bypass_cache;
这样既不查旧缓存，也不存新响应，形成“双保险”。
如何确认配置已生效
不能只看配置是否写对，要通过真实请求验证：
- 加头发起请求：
curl -H "X-Bypass-Cache: 1" https://example.com/api/status - 检查响应头：
X-Cache-Status: BYP（需提前配置add_header X-Cache-Status $upstream_cache_status;） - 查看 access 日志：
$upstream_cache_status字段应为BYP，而不是HIT或MISS - 对比无头请求：确认普通请求仍能命中缓存，证明策略未误伤正常流量
