验证缓存绕过需三步闭环：用带标识请求触发（Header/参数/Cookie）、检查响应头X-Cache-Status是否为BYPASS、比对直连后端响应一致性；同时排除浏览器缓存、CDN干扰及配置错位。
要验证调试状态下缓存是否实时绕过，关键不是“配没配对”，而是用真实请求触发、观察响应行为、比对中间状态——三步闭环验证即可确认。
用带标识的请求发起测试
选一种你配置好的 bypass 触发方式，发请求并确保它能被 Nginx 识别：
- 如果用 Header：运行 curl -H "X-Bypass-Cache: 1" -I https://your-domain.com/api/data
- 如果用参数：访问 https://your-domain.com/api/data?nocache=1
- 如果用 Cookie：先登录或手动设置 Cookie，再请求，例如 curl -b "dev_mode=1" -I https://your-domain.com/api/data
注意：不要只看返回内容是否“新”，重点是看响应头和日志中是否体现“绕过”动作。
检查响应头与日志中的 bypass 标识
Nginx 提供了内置变量 $upstream_cache_status，它会明确告诉你本次请求的缓存决策结果：
- 在对应 location 块中加一句：add_header X-Cache-Status $upstream_cache_status;
- 重启 Nginx 后，再次发起上述测试请求，用 curl -I 查看响应头
- 若看到 X-Cache-Status: BYPASS，说明成功绕过；若为 HIT/MISS/EXPIRED，则未生效
- 同时建议开启 access_log 记录该变量：log_format cache '$remote_addr - $upstream_cache_status "$request"';，便于回溯
对比绕过请求与直连后端的一致性
BYPASS 生效 ≠ 后端收到正确请求。需确认请求是否完整透传：
- 用相同参数，curl -v 直连后端服务（如 curl -v http://backend-ip:8080/api/data?nocache=1）
- 对比两个响应的：HTTP 状态码、响应体内容、Set-Cookie、X-Request-ID、自定义 Header
- 若不一致，问题不在“是否绕过”，而在 proxy_pass 是否透传了 Cookie、Authorization、query string 或 body
- 临时在 location 中加日志：log_format debug '$args | $http_cookie | $http_authorization | $request_body';，确认原始字段是否被截断或清空
避免常见干扰项
很多“看似没绕过”的情况其实来自其他环节：
- 浏览器自身缓存干扰：测试时用 curl，或 Chrome DevTools 中勾选 Disable cache 后刷新
- CDN 或 WAF 层提前拦截：若 Nginx 前还有 CDN，需确认它是否也支持并启用了同类 bypass 逻辑
- 配置未生效：确保 proxy_cache_bypass 和 proxy_cache 在同一 location 块内，且 keys_zone 名称完全匹配
- 变量值不符合规则：比如 X-Bypass-Cache: 0 或 X-Bypass-Cache: off 不会触发，必须是非空且非 "0"/"off"
