配置 nginx 代理缓存需要定义 proxy_cache_path 存储路径并设置权限,同时在 server 或 location 块中启用 proxy_cache 并指定缓存键。这样做会将后端返回的响应按规则存储在磁盘上,后续相同请求直接命中缓存而不再请求后端。若需强制刷新或忽略缓存,可通过添加特定的 cache-control 请求头或修改 proxy_cache_key 来实现。

如何定义缓存存储路径与基础开关
在 http 上下文中使用 proxy_cache_path 指令来指定缓存文件的存放目录、共享内存区域名称以及缓存的生命周期参数。接着在 location 块中使用 proxy_cache 指令引用该内存区域以开启缓存功能。默认情况下,Nginx 仅缓存状态码为 200 和 301 的响应,且会根据后端返回的 Cache-Control 头部来决定是否缓存及过期时间。
http {
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
server {
location /api/ {
proxy_pass http://backend_server;
proxy_cache my_cache;
proxy_cache_valid 200 301 10m;
}
}
}
上述配置将缓存文件存储在 /var/cache/nginx,采用两级子目录结构(levels=1:2)以避免单目录文件过多。共享内存区域 my_cache 大小为 10MB,用于存储缓存键和元数据。最大磁盘占用限制为 1GB,超过后根据 LRU 算法移除旧数据。inactive 参数设置为 60 分钟,意味着如果文件在 60 分钟内未被访问,即使未到 TTL 也会从缓存中删除。缓存有效期针对 200 和 301 状态码设为 10 分钟。
预期结果:首次请求 /api/data 时,Nginx 向后端发起请求并将响应存入磁盘。随后的 10 分钟内,对同一 URL 的请求将直接从 /var/cache/nginx 读取并返回,后端日志中不会显示新的请求记录。

如何处理缓存键冲突与动态内容
当 API 包含查询参数或用户特定信息时,默认的缓存键可能不够精确,导致不同用户看到相同数据或缓存命中率低。通过自定义 proxy_cache_key 可以控制哪些请求被视为“相同”。同时,对于需要实时性的接口,可以通过 proxy_no_cache 或 proxy_cache_bypass 指令绕过缓存逻辑。
location /api/user/ {
proxy_pass http://backend_server;
proxy_cache my_cache;
proxy_cache_key "$scheme$request_method$host$request_uri$is_args$args";
# 忽略带有 auth-token 头的请求,不缓存也不从缓存读取
proxy_cache_bypass $http_authorization;
proxy_no_cache $http_authorization;
}
在此配置中,proxy_cache_key 包含了请求方法、主机、URI 以及查询参数($args)。这意味着 /api/user?id=1 和 /api/user?id=2 会被视为不同的缓存条目。如果后端返回了 Cache-Control: no-cache,Nginx 默认会尊重该指令而不缓存。但通过 proxy_cache_bypass 和 proxy_no_cache 检查 $http_authorization 变量,当请求携带 Authorization 头时,Nginx 既不会尝试从缓存中获取响应,也不会将新响应存入缓存,从而保证认证用户的实时数据。
预期结果:匿名请求 /api/user?id=1 会被缓存。带 Authorization 头的请求 /api/user?id=1 将直接转发给后端,且结果不被缓存。这解决了基于会话的动态内容缓存污染问题。

缓存命中时返回的 HTTP 状态码是什么
当 Nginx 成功从本地缓存中检索到匹配的响应时,它不会返回标准的 200 OK,而是返回 200 (HIT) 状态码。这个状态码表明响应内容来自缓存而非后端服务器。开发者可以通过检查响应头中的 X-Cache-Status(如果配置了)或直接观察状态码后缀来验证缓存行为。未命中时则返回标准的 200 OK,表示内容新鲜或重新生成。
为了更清晰地监控缓存状态,通常建议添加 add_header 指令来显式输出缓存状态。例如:add_header X-Cache-Status $upstream_cache_status;。这样在浏览器开发者工具或 curl 响应头中,可以直接看到 HIT、MISS、EXPIRED 或 BYPASS 等值,便于调试和性能分析。











