Nginx 缓存有效期如何配置
在 nginx 中配置缓存有效期主要通过 proxy_cache_valid 指令实现,该指令允许你根据 http 状态码设置不同的缓存时长。例如,使用 proxy_cache_valid 200 302 10m; 可以将成功响应(200)和重定向(302)的缓存时间设置为 10 分钟,而 proxy_cache_valid 404 1m; 则针对 404 错误设置 1 分钟的缓存。这些配置必须放在 http、server 或 location 块中,且需配合 proxy_cache_path 定义缓存存储路径才能生效。

server {
listen 80;
server_name example.com;
# 定义缓存路径和参数
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
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 1m;
# 添加缓存头以便调试
add_header X-Cache-Status $upstream_cache_status;
}
}
上述配置中,keys_zone 定义了共享内存区域的大小,用于存储缓存键和元数据。max_size 限制磁盘缓存的最大容量,inactive 指定非活跃缓存项在磁盘上保留的时间。通过 X-Cache-Status 响应头,可以查看请求是命中缓存(HIT)、未命中(MISS)还是其他状态,从而验证缓存是否按预期工作。
缓存时间监控如何实现
监控 Nginx 缓存效果的核心在于分析 $upstream_cache_status 变量,它记录了每个请求的缓存状态。可以通过日志格式配置将这一变量记录到访问日志中,进而结合监控工具如 Prometheus 或 ELK 进行可视化分析。此外,Nginx 模块 ngx_http_proxy_module 提供了详细的缓存命中率统计,可通过 stub_status 或自定义日志解析来获取实时数据。

# nginx.conf 中的日志格式配置
log_format cache_log '$remote_addr - $remote_user [$time_local] '
'"$request" $status $body_bytes_sent '
'"$http_referer" "$http_user_agent" '
'cache_status=$upstream_cache_status';
access_log /var/log/nginx/access.log cache_log;
在日志配置中,cache_status=$upstream_cache_status 将缓存状态追加到每条日志记录的末尾。通过分析日志文件,可以计算缓存命中率:命中次数除以总请求数。例如,若日志显示 1000 次请求中有 800 次为 HIT,则命中率为 80%。这种基于日志的分析方法简单有效,无需额外安装插件即可实现基础监控。
基于 $upstream_cache_status 的具体问题排查
当发现缓存命中率低时,$upstream_cache_status 的值能提供直接线索。常见状态包括 HIT(命中)、MISS(未命中)、EXPIRED(已过期)、BYPASS(绕过)和 STALE(陈旧)。若大量请求显示 MISS,可能原因包括缓存键冲突、后端返回了禁止缓存的头信息(如 Cache-Control: no-cache),或缓存路径权限不足导致写入失败。
以 MISS 为例,检查后端响应头是否包含 Cache-Control: no-store 或 private,这些指令会阻止 Nginx 缓存内容。同时,确认 proxy_cache_key 设置是否合理,默认键为 $scheme$proxy_host$request_uri,若 URI 包含动态参数可能导致缓存失效。通过调整 proxy_cache_key 或修改后端头信息,可优化缓存行为。例如,设置 proxy_cache_key $uri$is_args$args; 可更精确地控制缓存粒度。











