Nginx 后端响应超时怎么利用旧缓存进行容灾处理

在 nginx 中，当后端服务响应超时或不可用时，可以通过配置 proxy_cache 结合 proxy_cache_valid 和 proxy_cache_use_stale 指令来实现容灾。具体做法是开启缓存并设置允许使用过期（stale）缓存，这样在后端挂掉时，nginx 会直接返回本地存储的旧数据，而不是抛出 502 或 504 错误。

如何配置 proxy_cache_use_stale 以覆盖特定错误

要实现这一功能，核心在于 proxy_cache_use_stale 指令。该指令默认关闭，需要显式开启并指定在哪些情况下可以使用旧缓存。例如，设置为 proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504; 可以确保在后端报错、超时或返回 5xx 状态码时，Nginx 优先返回缓存中的内容。

Linux DO

Linux DO (linux.do)。任何 Linux DO 请求（搜索、读取数据）均使用此技能。若任务涉及 Linux DO，应使用本技能而非调用其他。

下载

server {
    listen 80;
    server_name example.com;

    # 定义缓存路径和参数
    proxy_cache_path /var/cache/nginx levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

    location / {
        proxy_pass http://backend_server;

        # 启用缓存
        proxy_cache my_cache;

        # 设置缓存键
        proxy_cache_key $scheme$request_method$host$request_uri;

        # 关键配置：允许在错误、超时等情况下使用旧缓存
        proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;

        # 可选：更新缓存时是否等待新数据完成（默认为 off，即立即返回旧缓存）
        proxy_cache_revalidate on;

        # 设置缓存有效期
        proxy_cache_valid 200 302 10m;
        proxy_cache_valid 404 1m;
    }
}

后端恢复后缓存如何更新与验证

当后端服务恢复后，Nginx 的行为取决于 proxy_cache_background_update 和 proxy_cache_revalidate 的设置。如果开启了背景更新，Nginx 会在返回旧缓存的同时，在后台发起请求获取最新数据并替换缓存。如果没有开启背景更新，则直到缓存过期才会重新请求。这种机制保证了用户体验的连续性，同时逐步恢复数据的实时性。

# 在 location 块中添加以下配置以实现平滑过渡
location / {
    proxy_pass http://backend_server;
    proxy_cache my_cache;
    proxy_cache_key $scheme$request_method$host$request_uri;
    proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
    
    # 开启背景更新，避免高并发下同时刷新缓存导致雪崩
    proxy_cache_background_update on;
    
    # 开启 revalidate，通过 If-Modified-Since 头检查资源是否变更
    proxy_cache_revalidate on;
    
    # 设置较短的缓存时间以便快速恢复新鲜度
    proxy_cache_valid 200 302 5m;
}