nginx 官方不支持 fastcgi_cache_revalidate 指令,所谓“revalidate”实为 fastcgi_cache_use_stale 配合 etag/last-modified 与 if_none_match/if_modified_since 实现的条件缓存刷新机制,需 php 正确输出校验头、nginx 稳定 cache_key 且禁用干扰响应头。

fastcgi_cache_revalidate 并不是 Nginx 官方支持的指令——它在标准模块中并不存在。很多配置文档里提到的这个参数,实际是混淆或误传。真正能降低 PHP-FPM 响应瓶颈、减少无效后端调用的机制,是一套协同生效的缓存策略,核心在于让 Nginx 自主判断是否返回 304,或在缓存过期时“轻量再验证”,而不是反复把请求甩给 PHP。
让 Nginx 自己响应 304,彻底绕过 PHP
这是最直接的减负方式:客户端带 If-Modified-Since 或 If-None-Match 请求,Nginx 查缓存中已有的 Last-Modified 或 ETag,匹配且缓存未过期(仍在 inactive 时间内),就直接返回 304,不发请求到 PHP。
- PHP 脚本必须输出规范头,例如:
header('Last-Modified: ' . gmdate('D, d M Y H:i:s', $mtime) . ' GMT');或header('ETag: "v1-' . md5($content) . '"'); - Nginx 配置中不能忽略这些头,确保没有
fastcgi_ignore_headers Last-Modified ETag; - 缓存 key 要稳定,推荐用:
fastcgi_cache_key "$scheme$request_method$host$request_uri";
启用真正的 revalidate 机制(需手动组合)
所谓“revalidate”效果,靠的是 fastcgi_cache_use_stale updating + 后端配合 ETag + 缓存有效期设置共同实现。当缓存过期,Nginx 不丢弃旧内容,而是带着 If-None-Match 向 PHP 发起条件请求,由 PHP 返回 304 来延长缓存,或返回 200 更新内容。
- 开启关键配置:
fastcgi_cache_revalidate on;—— 注意:该指令仅在某些第三方补丁版或较新商业版 Nginx 中存在;主流开源版(如 1.24+)仍不原生支持,需确认你所用版本是否启用该扩展 - 必须搭配:
fastcgi_cache_valid 200 301 302 10m;(设基础有效期)、fastcgi_cache_use_stale updating error timeout http_500;(允许 stale 状态下继续服务) - PHP 的 ETag 必须真实反映内容变更,不能是随机值或固定字符串,否则 304 永远不触发
避免常见干扰项,防止缓存失效
很多看似合理的配置,反而会让 revalidate 或 304 失效:
- PHP 输出了
Cache-Control: no-cache、Pragma: no-cache或Expires: 0—— 这些会覆盖 Nginx 缓存行为,建议统一由 Nginx 控制缓存策略,PHP 不主动设禁用类头 - fastcgi_cache_key 中混入时间戳、session_id、随机参数等动态变量 —— 导致同一页面无法复用缓存
- fastcgi_ignore_headers 包含了 Expires 或 Cache-Control —— Nginx 可能丢弃关键缓存控制信息
补充兜底:stale 状态保障可用性
即使 PHP 临时不可用,用户也不该看到错误页。启用 updating 和 error timeout http_500 等 stale 状态,能让 Nginx 在后台静默刷新缓存的同时,继续用旧内容响应用户。
fastcgi_cache_use_stale updating error timeout http_500 http_502 http_503 http_504;- 配合
fastcgi_cache_lock on;(防缓存击穿)和fastcgi_cache_lock_timeout 5s;更稳妥 - 加个调试头方便排查:
add_header X-Cache $upstream_cache_status;











