要让带nocache参数的请求真正穿透Nginx缓存，必须同时满足proxy_cache_bypass $arg_nocache（读绕过）、proxy_no_cache $arg_nocache（写拦截）且两者同location生效，否则仍可能走缓存或污染缓存。
要让带 nocache 参数的请求真正穿透 Nginx 缓存、直连后端，不能只靠加个参数就完事。关键在于配置必须满足“读绕过 + 写拦截 + 变量生效”三要素，否则请求可能仍走缓存，或把错误响应又存进缓存里。
确保 proxy_cache_bypass 正确识别 ?nocache=1
只需一行配置即可触发读绕过：
-
proxy_cache_bypass $arg_nocache;—— 这是核心，Nginx 会检查查询参数nocache是否存在且非空、非"0"或"off" - 合法触发值包括：
?nocache=1、?nocache=true、?nocache=anystring；而?nocache=0或?nocache=（空值）不会绕过 - 注意：该指令必须和
proxy_cache mycache;出现在同一个location块中，否则完全不生效
防止绕过请求污染缓存池
仅用 proxy_cache_bypass 不够——它只跳过读取，但后端返回的响应仍可能被缓存（尤其当返回 Cache-Control: public 时）。必须同步拦截写入：
-
proxy_no_cache $arg_nocache;—— 和 bypass 共用同一变量，确保 nocache 请求的响应绝不落盘 - 更稳妥的做法是合并多个绕过信号：
proxy_no_cache $arg_nocache $http_x_bypass $cookie_dev_mode; - 避免写成
proxy_no_cache 1;—— 这是静态常量，会导致所有请求都不缓存，违背“按需绕过”初衷
验证是否真穿透成功
别只看状态码，重点查响应头和日志字段：
- 用
curl -I "https://example.com/api?nocache=1"查看响应头：
应无X-Cache: HIT，理想情况是X-Cache: MISS或你自定义的X-Cache-Status: BYPASS - 开启 Nginx 日志记录
$upstream_cache_status变量：
绕过成功时该字段值为 BYPASS（不是 MISS） - 对比普通请求与 nocache 请求的
X-Upstream-Addr，确认是否都打到了后端真实服务，而非从缓存返回
进阶建议：防雪崩 + 权限控制
开发或调试场景下，大量 nocache 请求可能压垮后端。加上两道防护更稳：
- 启用缓存锁：
proxy_cache_lock on;+proxy_cache_lock_timeout 3s;，避免重复回源 - 限制可触发绕过的来源：
用map或if判断 IP 段（如仅允许192.168.0.0/16），再组合变量：set $bypass 0;<br>if ($remote_addr ~ ^(192\.168\.|10\.) ) { set $bypass 1; }<br>proxy_cache_bypass $bypass $arg_nocache;
