Nginx 后端宕机时怎么启用过期缓存兜底
在 nginx 中,当后端服务器宕机或连接失败时,可以通过配置 `proxy_cache` 配合 `proxy_cache_valid` 和 `error_page` 指令来实现使用过期缓存进行兜底。具体做法是:首先确保启用了 `proxy_cache_path` 并设置了合理的缓存路径;然后使用 `proxy_cache_valid` 定义不同状态码的缓存时间(包括非 200 状态的缓存);接着通过 `error_page 500 502 503 504 /cached_error.html;` 将错误页面指向一个由缓存提供的静态或动态响应;最后结合 `proxy_next_upstream` 和 `proxy_ignore_client_abort` 等指令优化重试行为。这样即使后端完全不可用,nginx 仍可向客户端返回之前缓存的内容,提升系统可用性。

如何配置 proxy_cache_valid 以支持非成功状态码的缓存
要使过期缓存生效,必须显式告诉 Nginx 哪些 HTTP 状态码对应的响应可以被缓存,包括 5xx 错误码。默认情况下,Nginx 只缓存 200、301、302 等成功状态码,而不会缓存 500、502 等错误响应。因此需要手动设置 `proxy_cache_valid 500 502 503 504 10m;` 来允许这些错误响应被缓存一定时间。同时建议设置 `proxy_cache_use_stale updating error timeout http_500 http_502 http_503 http_504;` 以便在后端故障时优先使用 stale 缓存。此外,还需注意 `proxy_cache_min_uses` 和 `proxy_cache_background_update` 的配合使用,避免频繁刷新导致缓存失效。

server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend_servers;
proxy_cache my_cache;
proxy_cache_valid 200 302 10m;
proxy_cache_valid 404 1m;
proxy_cache_valid 500 502 503 504 5m;
proxy_cache_use_stale error timeout http_500 http_502 http_503 http_504 updating;
proxy_cache_lock on;
proxy_cache_key $scheme$request_method$host$request_uri;
add_header X-Cache-Status $upstream_cache_status;
}
}
当后端全部宕机时,Nginx 如何判断是否返回缓存内容
当所有后端服务器都宕机时,Nginx 会根据 `proxy_cache_use_stale` 的设置决定是否返回缓存内容。如果设置了 `http_500 http_502 http_503 http_504`,则在这些错误发生时,Nginx 会尝试从缓存中获取 stale 版本并返回给客户端。此时,若缓存中存在该 URL 的旧响应,且其 TTL 未过期或处于“可更新”状态,Nginx 就会直接返回该缓存内容,而不等待后端恢复。需要注意的是,只有当缓存中存在对应资源的 stale 副本时才会生效,否则仍会返回 502 或 504 错误。此外,`proxy_cache_lock` 可以防止多个并发请求同时触发对同一资源的后台更新,减少后端压力。
# 验证命令示例 # 模拟后端宕机后访问测试接口 curl -I http://example.com/test # 预期输出应包含如下头部信息: # HTTP/1.1 200 OK # X-Cache-Status: STALE # Content-Type: application/json # ...其他正常响应头...











