要真正阻止敏感响应进入代理缓存，必须同时配置 proxy_cache_bypass 和 proxy_no_cache，并统一用 map 指令将登录态、角色、UA、路径、响应头等特征转为 0/1 变量，任一变量为 1 即全程绕过缓存。
要真正阻止敏感响应进入代理缓存，不能只靠 proxy_no_cache 单独工作——它只管“不存”，不管“不读”。必须配合 proxy_cache_bypass 才能实现从请求发起端就跳过缓存、同时确保响应也不写入缓存的完整旁路。
用 map 提取关键请求特征，生成可控布尔变量
直接在 proxy_no_cache 里写正则或复杂条件容易出错且不可维护。推荐统一用 map 指令把各类敏感信号转为 0/1 变量：
- 检测登录态：用 Cookie 判断是否含有效 session
- 识别高权限角色：匹配自定义 Header 如
X-User-Role - 区分设备类型：UA 中含 Mobile 或 iPhone 视为个性化终端
- 拦截调试路径：URI 以
/admin/或/api/v1/debug开头 - 响应头触发：如上游返回
X-No-Cache: true时也绕过
示例配置（放在 http 块中）：
map $cookie_sessionid $no_cache_by_login {
~. 1;
default 0;
}
map $http_x_user_role $no_cache_by_role {
"admin" 1;
"editor" 1;
default 0;
}
map $http_user_agent $no_cache_by_ua {
~*Mobile 1;
~*iPhone 1;
default 0;
}
map $request_uri $no_cache_by_path {
~*^/admin/ 1;
~*^/api/v[12]/debug 1;
default 0;
}
location 中必须同时启用 proxy_cache_bypass 和 proxy_no_cache
这两个指令要成对出现，且传入相同的变量列表。Nginx 对它们的处理逻辑是“任一变量非空即生效”：
FastAPI Flask Proxy
下载
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
-
proxy_cache_bypass $no_cache_by_login $no_cache_by_role $no_cache_by_ua $no_cache_by_path→ 请求阶段跳过缓存查找，直连后端 -
proxy_no_cache $no_cache_by_login $no_cache_by_role $no_cache_by_ua $no_cache_by_path→ 响应阶段禁止写入缓存，避免误存敏感内容
注意：只要其中一个变量值为 1（比如用户带了 session ID），整条请求就完全脱离缓存链路。
避免影响静态资源和匿名访问
默认行为应是“缓存友好”，仅对明确标记的请求做干预：
- 所有
map的default必须设为 0，防止空值、缺失字段等意外触发绕过 - 不要在全局
http块中直接写proxy_no_cache $cookie_sessionid，这会导致未登录用户因 cookie 为空字符串也被误判 - 对
/static/、/images/、.js、.css等路径单独配location，跳过上述 map 判断，专注用expires或proxy_cache_valid管理即可
补充：支持运行时参数强制绕过（适合调试与灰度）
开发或上线初期，可通过 URL 参数快速验证效果：
map $args $no_cache_by_arg {
~debug=1 1;
~nocache=1 1;
~v=[^&]+ 1;
default 0;
}
再将 $no_cache_by_arg 加入前面两个指令的变量列表中。例如访问 /user/profile?debug=1 就会立即回源，不查缓存也不存缓存，方便定位问题。
