最有效方式是为不同状态码单独配置proxy_cache_valid;需按顺序显式声明,如200/301/302/206/304缓存1h、301缓存7d、404缓存30s、5xx缓存10s、any兜底5s,并确保proxy_cache_path、proxy_cache及响应可缓存三者同时满足。

直接用 proxy_cache_valid 为不同状态码写独立规则,是最有效的方式。它不依赖后端响应头,而是由 Nginx 主动控制缓存时长,对稳定性与抗压能力提升明显。
按状态码语义分组设置合理时长
不同状态码代表不同业务含义,缓存周期应匹配其稳定性与敏感性:
-
200 / 301 / 302 / 206 / 304:正常响应或协商成功,内容通常稳定 → 可设为
proxy_cache_valid 200 206 304 1h;;301 是永久重定向,适合长期缓存,如proxy_cache_valid 301 7d; -
404:资源不存在,缓存过长会导致“假 404”,掩盖新上线内容 → 建议
proxy_cache_valid 404 30s;,最长不超过 1 分钟 -
500 / 502 / 503 / 504:后端故障类错误,短时缓存可缓解雪崩 → 推荐
proxy_cache_valid 500 502 503 504 10s; -
any:兜底规则,覆盖所有未显式声明的状态码 → 如
proxy_cache_valid any 5s;,注意它不会覆盖已定义的状态码
确保缓存真正生效的三个硬性前提
仅写 proxy_cache_valid 不起作用,必须同时满足:
- 在
http块中定义缓存区:proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g; - 在
location中启用该缓存:proxy_cache my_cache; - 上游响应本身要“可缓存”:默认不缓存含
Cache-Control: no-cache、private或Set-Cookie的响应;必要时加proxy_ignore_headers Cache-Control Set-Cookie;强制忽略
利用配置层级实现精细控制
Nginx 支持在不同作用域重复使用 proxy_cache_valid,以**最近的作用域为准**:
- 全局策略(
http块):proxy_cache_valid 200 5m; any 1m; - 特定路径覆盖(
location /api/):proxy_cache_valid 200 30s; 500 5s; - 结果:该路径下 200 缓存 30 秒、500 缓存 5 秒,其余状态码仍走
any 1m
验证是否按预期工作
调试阶段建议添加标识头,直观判断缓存行为:
- 加一行:
add_header X-Cache-Status $upstream_cache_status; - 用
curl -I多次请求,观察响应头中X-Cache-Status是否出现HIT、MISS或EXPIRED - 注意:浏览器对 301 有强本地缓存,测试时优先用
curl绕过干扰











