在 nginx 中配置缓存有效期并分析日志,核心在于通过 expires 指令设置响应头中的 cache-control 和 expires,并在访问日志中记录这些状态码以验证生效情况。具体做法是在 location 块中添加 expires 指令(如 expires 1h),nginx 会自动向客户端发送缓存过期时间;随后检查访问日志中的 304 not modified 状态码,若大量出现则说明缓存策略已正确应用。

Nginx 如何设置静态资源的缓存时长
要设置具体的缓存时长,需在 server 或 location 块中使用 expires 指令。该指令支持多种时间单位,如 m (分钟)、h (小时)、d (天) 或绝对时间 max。例如,将图片资源缓存一天,只需在匹配图片的 location 中写入 expires 1d。Nginx 会根据当前时间和设定的时长,计算出 Expires 的具体日期,并生成 Cache-Control: max-age=86400 响应头发送给浏览器。

server {
listen 80;
server_name example.com;
# 静态资源目录
location /static/ {
root /var/www/html;
# 设置缓存时间为1天
expires 1d;
# 可选:添加额外的 Cache-Control 头
add_header Cache-Control "public, no-transform";
}
location / {
proxy_pass http://backend;
}
}
上述配置中,当请求 /static/image.png 时,Nginx 会读取文件并附加缓存头。浏览器首次访问收到 200 OK 及缓存时间,后续在有效期内再次访问时,浏览器不会发起完整 HTTP 请求,而是直接返回 304 Not Modified(如果服务器支持)或直接使用本地缓存。这显著减少了带宽消耗和服务器负载。
如何通过日志分析确认缓存是否生效
缓存生效的直接证据体现在访问日志的状态码变化上。默认情况下,Nginx 的 access.log 记录了每次请求的状态码。当缓存命中且浏览器发送了条件请求(包含 If-Modified-Since 或 If-None-Match)时,Nginx 会返回 304 状态码。如果未启用 etag 或浏览器未发送条件请求,但仍在有效期内,浏览器可能直接使用本地缓存而不发请求,此时日志中甚至不会有记录。因此,重点观察 304 的比例即可判断。

# 假设 access.log 格式包含 $status
# 统计 304 状态码出现的次数
grep ' 304 ' /var/log/nginx/access.log | wc -l
# 或者使用 awk 更详细地分析
awk '{print $9}' /var/log/nginx/access.log | sort | uniq -c | sort -rn
运行上述命令后,如果 304 的数量占比较高(例如超过 50%),说明缓存配置正在发挥作用。如果全是 200,则需检查 expires 是否正确加载,以及浏览器是否忽略了缓存头(如开启了无痕模式)。此外,可以通过 curl -I http://example.com/static/image.png 手动查看响应头中的 Expires 和 Cache-Control 字段,确保其值与配置一致。
当缓存头被强制覆盖时日志会显示什么结果
如果在配置中使用了 add_header 显式设置了 Cache-Control,它会覆盖 expires 自动生成的行为。例如,若设置 add_header Cache-Control "no-cache",即使有 expires 指令,浏览器也会认为资源不过期,每次都会向服务器请求最新内容。此时,日志中将几乎看不到 304 状态码,所有请求都会返回 200。这是因为 no-cache 要求服务器在每次响应前验证资源有效性,除非资源确实未修改,否则总是返回完整内容。











