单靠 proxy_no_cache 只能禁止响应写入缓存，无法跳过缓存读取；必须与 proxy_cache_bypass 成对使用并共用同一变量，前者在请求阶段跳过缓存查找、后者在响应阶段阻止写入，任一变量为非空或非零即全程绕过缓存。
单靠 proxy_no_cache 只能禁止响应写入缓存，不能跳过缓存读取。要真正实现“绕过缓存”，必须让它和 proxy_cache_bypass 配合使用，并共用同一组判断变量。
为什么不能只配 proxy_no_cache
proxy_no_cache 仅作用于响应阶段：它决定 Nginx 收到后端响应后，是否把该响应体存进缓存区。但它不干预请求阶段——Nginx 仍会先查本地缓存，命中就直接返回旧内容，根本不会发请求给后端。
例如，用户访问 /api/v1/user/profile，如果缓存里有 5 分钟前的响应，即使你设了 proxy_no_cache 1，Nginx 仍可能直接返回那个旧数据，后端压根没收到这次请求。
必须成对启用 bypass 和 no_cache
两个指令需传入完全相同的变量列表，Nginx 对它们的触发逻辑一致：任一变量值为非零或非空，整条请求就全程脱离缓存链路。
-
proxy_cache_bypass $skip_path $skip_role $skip_header→ 请求阶段跳过缓存查找，强制回源 -
proxy_no_cache $skip_path $skip_role $skip_header→ 响应阶段禁止写入缓存，防止敏感/错误响应被保存
二者缺一不可。只开 bypass 不开 no_cache，后端返回的 401 或调试 JSON 可能被误存；只开 no_cache 不开 bypass，用户看到的仍是过期缓存。
FastAPI + Flask 混合部署最佳实践，解决路由定义、API 代理等常见问题，适用于同时运行 FastAPI API 与 Flask 前端的场景。
用 map 提前定义清晰的判断变量
避免在 location 块里写复杂正则或嵌套判断。所有规则应在 http 块中用 map 统一声明，default 0 是关键，确保未匹配请求默认走缓存流程。
- 按路径：
map $request_uri $skip_path { ~*^/api/v1/user/ 1; ~*^/admin/ 1; default 0; } - 按角色头：
map $http_x_user_role $skip_role { "admin" 1; "dev" 1; default 0; } - 按上游响应头：
map $upstream_http_x_no_cache $skip_header { ~*true 1; default 0; }（后端返回X-No-Cache: true时生效）
location 中启用并验证效果
确保该 location 已启用缓存（proxy_cache my_cache），再加入双指令：
proxy_cache_bypass $skip_path $skip_role $skip_header;<br>proxy_no_cache $skip_path $skip_role $skip_header;
验证方式：
– 查看 Nginx 日志，确认目标请求是否带 MISS 或 BYPASS 标记
– 抓包或浏览器 Network 面板，检查响应状态码是否始终为 200（非 304），Size 是否为 from network
