在 nginx 中配置动态页面缓存,核心做法是结合 proxy_cache 启用缓存功能,并通过 proxy_cache_valid 指令针对特定的 http 状态码(如 200)设置具体的缓存有效期。这样做可以让 nginx 将后端返回的动态内容视为静态资源进行存储,后续相同请求直接由 nginx 响应,从而减轻后端压力。需要注意的是,如果后端返回的响应头中包含 cache-control 或 expires,nginx 默认会优先遵循后端的指示,因此必须使用 proxy_ignore_headers 忽略这些头部,才能确保 proxy_cache_valid 的配置生效。

如何配置基础缓存路径与忽略后端控制头
要实现上述效果,首先需要定义一个磁盘上的缓存目录,并告诉 Nginx 忽略后端服务器发来的缓存控制指令。通过 proxy_ignore_headers 忽略 Cache-Control 和 Expires,可以强制 Nginx 使用自身配置的 proxy_cache_valid 规则,而不是盲从后端的短时效设置。

server {
listen 80;
server_name example.com;
# 1. 定义缓存路径:levels=1:2 表示两级目录结构,keys_zone=my_cache:10m 分配10MB共享内存用于键管理,inactive=60m 表示60分钟未访问则删除
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m inactive=60m;
location /api/dynamic {
# 2. 启用缓存并指定刚才定义的 zone
proxy_cache my_cache;
# 3. 关键步骤:忽略后端返回的 Cache-Control 和 Expires 头
# 这样 Nginx 就不会因为后端说“不缓存”而跳过缓存逻辑
proxy_ignore_headers Cache-Control Expires;
# 4. 设置缓存有效期:对 200 和 302 状态的响应缓存 10 分钟
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
# 5. 设置缓存键:通常基于 URI 和 Host
proxy_cache_key $scheme$request_method$host$request_uri;
# 6. 代理指向后端服务
proxy_pass http://backend_server;
}
}
在上述配置中,/var/cache/nginx 是实际存储缓存文件的目录,需确保 Nginx 运行用户有写入权限。keys_zone 的大小决定了能存储多少个缓存键的元数据,对于高并发场景建议适当调大。忽略头部后,所有匹配该 location 的请求,只要后端返回 200,Nginx 就会将其缓存 10 分钟。在这 10 分钟内,无论后端数据是否更新,Nginx 都会直接返回缓存中的旧数据,直到缓存过期或被清除。
如何处理缓存键冲突与特定参数过滤
动态页面往往带有查询参数(Query String),例如 /api/user?id=1 和 /api/user?id=2。默认的缓存键包含整个 $request_uri,这会导致每个不同的 ID 都生成独立的缓存文件,可能迅速耗尽磁盘空间。为了解决这个问题,可以通过修改 proxy_cache_key 来过滤掉不必要的参数,或者针对特定参数进行差异化缓存。

# 方案 A:完全忽略查询参数,所有 /api/user 请求共用同一份缓存
# 适用于参数不影响核心内容展示的场景,如分页、排序等
proxy_cache_key $scheme$host$uri;
# 方案 B:仅保留特定参数作为缓存键的一部分
# 假设只有 id 参数影响内容,其他参数如 page, sort 被忽略
# 需要配合 map 指令或复杂的变量拼接,这里展示简化思路
# 实际生产中常使用 map 提取特定参数
map $args $cache_key_args {
~*id=(\d+) $1; # 提取 id 的值
default ""; # 如果没有 id,则为空
}
location /api/user {
proxy_cache my_cache;
proxy_ignore_headers Cache-Control Expires;
proxy_cache_valid 200 10m;
# 使用自定义的缓存键,只包含 id
proxy_cache_key $scheme$host$uri$is_args$args_id;
proxy_pass http://backend_server;
}
当使用方案 A 时,/api/user?page=1 和 /api/user?page=2 将命中同一个缓存对象。如果后端内容确实不随页码变化(例如只是获取用户基本信息),这是高效的做法。但如果内容随参数变化,必须采用方案 B 或更精细的 map 配置,确保不同业务逻辑的请求生成不同的缓存键。此外,若希望彻底清除某个 URL 的缓存,可以使用 proxy_cache_purge 模块(需第三方支持)或手动删除 /var/cache/nginx 下对应的文件。
基于 proxy_cache_valid 状态码的具体行为验证
在配置了 proxy_cache_valid 后,不同 HTTP 状态码的处理逻辑直接影响缓存命中率与用户体验。以 200 OK 和 404 Not Found 为例,前者代表成功获取动态内容,后者代表资源不存在。通过对比这两种状态码的缓存策略,可以验证配置是否按预期工作。
# 测试脚本:curl -I http://example.com/api/dynamic # 第一次请求(后端返回 200) HTTP/1.1 200 OK Server: nginx/1.24.0 X-Cache-Status: MISS # 首次请求,未命中缓存 # 第二次请求(后端仍返回 200,但在 10 分钟有效期内) HTTP/1.1 200 OK Server: nginx/1.24.0 X-Cache-Status: HIT # 命中缓存,直接返回 Nginx 本地存储 # 模拟后端返回 404 # 第一次请求(后端返回 404) HTTP/1.1 404 Not Found Server: nginx/1.24.0 X-Cache-Status: MISS # 第二次请求(后端仍返回 404,但在 1 分钟有效期内) HTTP/1.1 404 Not Found Server: nginx/1.24.0 X-Cache-Status: HIT # 命中 404 缓存,避免重复查询后端
在实际验证中,可以通过添加 X-Cache-Status 响应头(使用 add_header X-Cache-Status $upstream_cache_status;)来直观查看缓存命中情况。当 proxy_cache_valid 404 1m; 生效时,Nginx 会将 404 响应也缓存起来,这在防止“缓存穿透”或减少无效后端请求方面非常有效。如果后端在某些情况下返回 500 Internal Server Error,而配置中未指定 proxy_cache_valid 500,则 500 错误不会被缓存,每次都会回源,这有助于在系统异常时快速恢复真实数据,避免长期缓存错误状态。


















