Nginx 缓存失效处理如何配置缓存失效回滚

夏磊君_5730

夏磊君_5730

2026-11-22

936人浏览

原创

在 nginx 中,缓存失效回滚的核心做法是配置 proxy_cache_path 的 inactive 参数。该参数定义了缓存文件在未被访问的情况下保留的最长时间,超过这个时间后,nginx 会在后台清理这些文件,从而实现类似“回滚”或自动回收的效果。如果希望立即强制清除所有缓存,可以结合 proxy_cache_purge 模块或手动删除磁盘上的缓存目录文件。

Nginx 缓存失效处理如何配置缓存失效回滚

如何设置缓存文件的存活周期以自动清理旧数据

通过设置 inactive 参数,可以指定缓存文件在多久不活跃后被移除。这是处理缓存失效最基础且常用的方法,适用于大多数需要定期更新数据的场景。

Nginx 缓存失效处理如何配置缓存失效回滚

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;
        proxy_cache my_cache;
        proxy_cache_valid 200 302 10m;
        proxy_cache_valid 404 1m;
        proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;
        add_header X-Cache-Status $upstream_cache_status;
    }
}

在上述配置中,inactive=60m 表示如果一个缓存文件在 60 分钟内没有被客户端访问过,它将被视为不活跃并从缓存中删除。这意味着即使原始响应头中没有设置过期时间,Nginx 也会根据这个时间限制来管理缓存的生命周期。这种机制确保了过期的内容不会永久占用磁盘空间,同时也避免了因后端服务不可用而长期提供陈旧数据的问题。

如何实现基于特定条件的缓存失效与回滚

除了基于时间的自动清理,有时需要根据特定的业务逻辑或条件来触发缓存失效。这通常涉及到更复杂的配置,例如使用 proxy_cache_bypass 或结合外部工具进行动态控制。

Nginx Reverse Proxy
Nginx Reverse Proxy

配置 Nginx 反向代理,实现域名绑定。用户说“绑定域名”“配置 Nginx”“反向代理”时触发,将域名绑定到指定 IP:端口。

下载

Nginx 缓存失效处理如何配置缓存失效回滚

# 假设有一个脚本用于清除特定前缀的缓存
# 这里展示的是如何通过 Nginx 配置实现简单的缓存 bypass
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;

    location / {
        proxy_pass http://backend;
        proxy_cache my_cache;
        
        # 如果请求头中包含 'Cache-Control: no-cache',则绕过缓存
        proxy_cache_bypass $http_cache_control;
        
        # 或者根据 cookie 值决定是否使用缓存
        # proxy_cache_bypass $cookie_nocache;
        
        add_header X-Cache-Status $upstream_cache_status;
    }
}

在这个例子中,proxy_cache_bypass 指令允许我们根据请求中的特定条件(如 Cache-Control 头部或 Cookie)来决定是否跳过缓存。当客户端发送带有 no-cache 指令的请求时,Nginx 将直接向后端服务器发起请求,获取最新的数据,而不从本地缓存中读取。这种方式可以实现细粒度的缓存控制,满足某些需要实时性要求较高的场景。需要注意的是,这种方法并不能直接“回滚”已存在的缓存文件,而是通过绕过缓存来获取新数据,从而间接达到更新内容的目的。

当后端返回 500 错误时,Nginx 如何处理缓存状态

在后端服务出现异常时,Nginx 的缓存行为可以通过 proxy_cache_use_stale 指令进行调整。这一配置决定了在何种错误情况下,Nginx 应该返回旧的缓存内容而不是直接报错。

在之前的配置示例中,我们已经看到了 proxy_cache_use_stale 的使用:proxy_cache_use_stale error timeout updating http_500 http_502 http_503 http_504;。这意味着当后端返回 500、502、503 或 504 错误,或者发生超时、正在更新缓存等情况时,Nginx 会尝试返回之前缓存的 stale(陈旧)内容。这对于提高系统的可用性和用户体验非常重要,因为它可以在后端暂时不可用时,继续为用户提供部分可用的服务,而不是直接显示错误页面。然而,这也意味着用户可能会看到一些过时的数据,因此需要根据具体的业务需求来权衡利弊。

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx nginx 缓存

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
nginx 重启
nginx 重启

nginx重启对于网站的运维来说是非常重要的,根据不同的需求,可以选择简单重启、平滑重启或定时重启等方式。本专题为大家提供nginx重启的相关的文章、下载、课程内容,供大家免费下载体验。

2023.07.27

443

5

nginx 配置详解
nginx 配置详解

Nginx的配置是指设置和调整Nginx服务器的行为和功能的过程。通过配置文件,可以定义虚拟主机、HTTP请求处理、反向代理、缓存和负载均衡等功能。Nginx的配置语法简洁而强大,允许管理员根据自己的需要进行灵活的调整。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

4427

6

nginx配置详解
nginx配置详解

NGINX与其他服务类似,因为它具有以特定格式编写的基于文本的配置文件。本专题为大家提供nginx配置相关的文章,大家可以免费学习。

2023.08.04

7485

6

tomcat和nginx有哪些区别
tomcat和nginx有哪些区别

tomcat和nginx的区别:1、应用领域;2、性能;3、功能;4、配置;5、安全性;6、扩展性;7、部署复杂性;8、社区支持;9、成本;10、日志管理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.02.23

621

5

nginx报404怎么解决
nginx报404怎么解决

当访问 nginx 网页服务器时遇到 404 错误,表明服务器无法找到请求资源,可以通过以下步骤解决:1. 检查文件是否存在且路径正确;2. 检查文件权限并更改为 644 或 755;3. 检查 nginx 配置,确保根目录设置正确、没有冲突配置等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2024.07.09

1536

5

Nginx报404错误解决方法
Nginx报404错误解决方法

解决方法:只需要加上这段配置:try_files $uri $uri/ /index.html;即可。想了解更多Nginx的相关内容,可以阅读本专题下面的文章。

2024.08.07

4018

3

nginx部署php项目教程汇总
nginx部署php项目教程汇总

本专题整合了nginx部署php项目教程汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

142

12

nginx配置文件详细教程
nginx配置文件详细教程

本专题整合了nginx配置文件相关教程详细汇总,阅读专题下面的文章了解更多详细内容。

2026.01.13

637

23

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

2026.03.16

179

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习