在 nginx 中,`proxy_cache` 与 `proxy_pass` 配合的核心在于通过 `proxy_cache_key` 定义缓存的唯一标识,并利用 `proxy_cache_valid` 控制不同状态码的存活时间。配置时需在 `http` 或 `server` 块中声明 `proxy_cache_path` 存储目录,并在 `location` 块中启用缓存、设置密钥及后端地址,这样 nginx 会根据请求特征生成文件存储在磁盘上,后续相同请求直接返回缓存内容而不再转发给后端。

如何配置 proxy_cache_path 和 proxy_cache_key
要启用缓存功能,首先必须在 `http` 上下文中使用 `proxy_cache_path` 指令指定本地磁盘路径及元数据参数,例如 `levels=1:2` 用于分层存储以优化文件系统性能。接着在 `location` 块中通过 `proxy_cache` 指令引用该路径名称,并使用 `proxy_cache_key` 决定哪些请求被视为“相同”。通常将 `$scheme`、`$proxy_host` 和 `$request_uri` 组合为键值,确保协议、主机和路径完全一致时才命中缓存,若需忽略查询参数可将 `$query_string` 从键中移除。

http {
# 定义缓存路径,key 为 cache_zone,levels 为目录层级
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m;
server {
location /api/ {
# 启用缓存并指定区域
proxy_cache my_cache;
# 定义缓存键:方案 + 主机 + URI
proxy_cache_key "$scheme|$host|$request_uri";
# 设置后端地址
proxy_pass http://backend_servers;
}
}
}
如何设置缓存有效期与刷新策略
缓存生效的时间控制主要依赖 `proxy_cache_valid` 指令,它允许根据 HTTP 状态码设置不同的过期时间。例如 `200 301` 表示成功响应和重定向响应缓存 10 分钟,而 `404` 错误可设置较短时间如 1 分钟以避免重复请求无效资源。此外,可通过 `proxy_cache_revalidate` 开启温和刷新,当缓存过期后向源站发送带 `If-Modified-Since` 的请求,若源站返回 304 则更新缓存头而不重新下载内容。对于需要立即失效的场景,可结合 `proxy_cache_min_uses` 设置最低访问次数后才缓存,或使用 `proxy_no_cache` 排除特定参数或用户代理。

http {
proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m;
server {
location /api/ {
proxy_cache my_cache;
proxy_cache_key "$scheme|$host|$request_uri";
proxy_pass http://backend_servers;
# 200 OK 缓存 10 分钟,404 缓存 1 分钟
proxy_cache_valid 200 301 10m;
proxy_cache_valid 404 1m;
# 开启温和刷新
proxy_cache_revalidate on;
# 忽略 Cookie 参与缓存判断(可选)
proxy_cache_ignore_headers "Set-Cookie";
}
}
}
当后端返回 502 时缓存如何处理
当后端服务器不可用导致 Nginx 收到 502 Bad Gateway 错误时,默认情况下该错误响应不会被缓存,因为 `proxy_cache_valid` 未包含 502 状态码。这意味着每次请求都会尝试连接后端,可能加剧后端压力。若希望缓存错误页面以提升用户体验,可在 `proxy_cache_valid` 中添加 `502 5m`,使错误页缓存 5 分钟。同时建议配合 `proxy_next_upstream` 启用故障转移,让 Nginx 自动尝试其他后端节点,只有在所有节点均失败时才返回缓存的错误页(如果已配置)。需注意,缓存错误页可能导致用户看到陈旧错误信息,因此应合理设置较短的过期时间。











