Nginx 中如何配置 proxy_cache_valid 缓存频率-Nginx-PHP中文网

proxy_cache_valid 控制缓存有效期而非缓存频率，需配合状态码、content-type、缓存锁及bypass/no-cache指令协同配置：按状态码设ttl（如200/304缓存1h，5xx仅5s）；用map基于$sent_http_content_type动态赋值$cache_ttl；启用proxy_cache_lock防击穿；通过proxy_cache_bypass和proxy_no_cache实现条件绕过。

nginx 中如何配置 proxy_cache_valid 缓存频率

`proxy_cache_valid` 本身不控制“缓存频率”，它控制的是**缓存有效期（TTL）**——即响应被缓存后能保留多久、何时过期。所谓“缓存频率”，实际是指：哪些响应该缓存、缓存多久、什么条件下可复用、什么情况下跳过缓存。这些由 `proxy_cache_valid` 配合其他指令共同决定。下面从四个关键维度讲清楚怎么合理配置：

按 HTTP 状态码设定基础缓存时长

不同状态码语义不同，缓存策略应区别对待：

成功响应（200/206/304）：通常最值得缓存，例如静态资源或稳定 API
重定向（301/302）：可缓存但时间不宜过长，避免跳转逻辑变更后仍返回旧地址
客户端错误（404/403）：可缓存短时间（如 1–5 分钟），减少对无效路径的重复回源
服务端错误（5xx）：一般不缓存，或仅作极短兜底（如 5s），避免把故障响应长期固化

示例：

proxy_cache_valid 200 206 304 1h;
proxy_cache_valid 301 302 10m;
proxy_cache_valid 404 403 5m;
proxy_cache_valid 500 502 503 504 5s;

按 Content-Type 动态设置缓存时长

同一状态码下，不同资源类型更新节奏差异大。Nginx 原生不支持按响应头动态设 TTL，但可通过 map 指令 + $sent_http_content_type 实现：

匹配上游返回的 Content-Type（注意不是请求头 $http_content_type）
映射出变量（如 $cache_ttl），再在 proxy_cache_valid 中引用
规则顺序很重要：更具体的类型（如 application/json）要放在通用类型（如 application/）之前

示例（放在 http 块中）：

Nginx

在宝塔面板中轻松管理Nginx高性能Web服务器。提供可视化配置反向代理、负载均衡、SSL证书及HTTP缓存功能，一键优化高并发性能，助您高效搭建稳定、快速的网站运行环境。

下载

map $sent_http_content_type $cache_ttl {
  default "5s";
  ~*^text/ "1h";
  ~*^application/javascript "1h";
  ~*^image/ "24h";
  ~*^application/json "10s";
}

然后在 location 中使用：

proxy_cache_valid 200 302 $cache_ttl;