在 nginx 中配置缓存有效期,需要在 http 或 server 块中先使用 proxy_cache_path 定义缓存目录和基础参数,然后在 location 块中使用 proxy_cache_valid 指令指定不同 http 状态码对应的缓存时间。该指令支持按响应状态码(如 200、304)分别设置过期时间,单位可以是秒(s)、分钟(m)、小时(h)、天(d)或月(m),默认情况下未明确指定的状态码不会缓存。

如何为不同 HTTP 状态码设置不同的缓存时长
通过 proxy_cache_valid 指令可以针对特定的 HTTP 状态码设置独立的缓存有效期。例如,可以将成功的 200 和 302 响应缓存 10 分钟,而将错误页面如 404 仅缓存 1 分钟或不缓存。这种细粒度的控制有助于平衡资源加载速度与服务器压力,确保用户快速获取有效内容,同时避免长时间缓存失效或错误的页面。

worker_processes 1;
http {
# 定义缓存路径及基础参数
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_server;
proxy_cache my_cache;
# 针对不同状态码设置缓存时间
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_cache_valid any 1h;
}
}
}
如何处理动态内容或特定 URL 的缓存策略
对于包含用户个性化数据或频繁更新的动态内容,通常不应缓存或需极短缓存时间。可以通过 if 判断或 map 指令结合 proxy_no_cache 和 proxy_cache_bypass 来实现。例如,当请求头中包含 Authorization 时,直接跳过缓存;或者对以 .json 结尾的动态接口设置更短的缓存时间。这确保了敏感或实时数据的准确性,同时不影响静态资源的缓存效率。

worker_processes 1;
http {
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
# 定义是否需要 bypass 缓存的映射
map $http_authorization $no_cache_flag {
default 0;
~*^Bearer\s 1;
}
server {
listen 80;
server_name example.com;
location /api/ {
proxy_pass http://backend_api;
proxy_cache my_cache;
# 如果携带 Authorization 头,则不缓存
proxy_no_cache $no_cache_flag;
proxy_cache_bypass $no_cache_flag;
# 动态 API 内容缓存时间设短
proxy_cache_valid 200 5m;
}
location /static/ {
proxy_pass http://backend_static;
proxy_cache my_cache;
# 静态资源可长期缓存
proxy_cache_valid 200 1d;
}
}
}
缓存键(Cache Key)是如何生成的
Nginx 使用 proxy_cache_key 指令定义缓存文件的命名依据,默认为 $scheme$proxy_host$request_uri。这意味着相同的 URL 和协议会复用同一个缓存文件。如果后端服务根据 Cookie 或 Header 返回不同内容,但 Nginx 默认忽略这些头部,就会导致所有用户获取到同一份缓存内容。因此,若需区分用户,必须修改 proxy_cache_key 加入 $http_cookie 或 $http_user_agent,但这会显著增加缓存空间的消耗并降低命中率。


















