fastcgi_cache_bypass“全绕过”异常主因是变量恒为非空,如$cookie_phpsessid为空值、$http_pragma被cdn注入、$arg_nocache空参或$http_authorization全局存在;须用日志实测变量值,改用set+if或map精确校验,并严格成对配置fastcgi_cache_bypass与fastcgi_no_cache。

当 Nginx 的 fastcgi_cache_bypass 或 proxy_cache_bypass 出现“所有请求都绕过缓存”的异常,大概率是某个变量在所有请求中恒为非空值,导致条件永远成立。这不是配置写错了,而是变量语义被误用或取值范围失控。
检查变量是否恒为真值
绕过指令的逻辑是:任意一个变量展开后非空且不等于 "0" 或 "off",就触发绕过。常见“假恒真”变量有:
-
$cookie_PHPSESSID:若 PHP 未正确销毁会话、或前端脚本误设空 Session Cookie(如PHPSESSID=),Nginx 仍视其为非空字符串,全部绕过 -
$http_pragma:某些 CDN 或代理会自动注入Pragma: no-cache,导致全量绕过 -
$arg_nocache:前端埋点、监控 SDK 或 A/B 测试工具可能静默添加?nocache=参数(值为空),而空参数在 Nginx 中仍算“存在” -
$http_authorization:若网站启用了全局 Basic Auth(如 .htpasswd),即使普通用户访问也会带Authorization: Basic ...,全部绕过
验证变量实际取值
不要猜,要实测。在对应 location 块中临时加日志:
log_format debug_cache '$remote_addr - "$request" $cookie_PHPSESSID "$http_pragma" "$arg_nocache" "$http_authorization"';
access_log /var/log/nginx/debug_cache.log debug_cache;
然后发起几个典型请求(登录/未登录、带参/不带参、普通浏览/Ctrl+F5),查看日志中各变量真实内容。特别注意空字符串""、仅含空格、或 Base64 编码的 Authorization 值是否普遍存在。
用 set + if 精确控制绕过逻辑
当内置变量不可靠时,改用显式判断更安全:
- 只对真实有效的 Session 绕过:
set $skip_cache 0;
if ($cookie_PHPSESSID ~ ^[0-9a-f]{32}$) { set $skip_cache 1; }
再用fastcgi_cache_bypass $skip_cache; - 只接受明确的调试参数:
if ($arg_nocache = "1") { set $skip_cache 1; }
if ($arg_preview = "true") { set $skip_cache 1; } - 排除空值干扰:
map $arg_nocache $valid_nocache {
default "";
"1" "1";
"true" "1";
}
fastcgi_cache_bypass $valid_nocache;
确认 bypass 和 no_cache 同步生效
绕过读缓存 ≠ 阻止写缓存。如果只配了 fastcgi_cache_bypass 却漏掉 fastcgi_no_cache,PHP 返回的响应仍会被缓存——后续无 bypass 的请求反而拿到错误内容,容易误判为“全绕过”。务必成对出现:
fastcgi_cache_bypass $cookie_PHPSESSID $arg_nocache;
fastcgi_no_cache $cookie_PHPSESSID $arg_nocache;
并配合 add_header X-Cache-Status $upstream_cache_status; 查看响应头是否稳定返回 BYPASS,而非 HIT 或 MISS。











