讲师中心 微信公众号

工具推荐

视频效率加速
AniShort
AniShort

AI短剧协同制作平台

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

updream

一键生成高质量推广成片

Nginx 缓存失效处理如何配置灰度发布缓存清理

夏雪小哥_7405

夏雪小哥_7405

发布时间:2026-11-22 10:29:20

|

450人浏览过

|

来源于php中文网

原创

在 nginx 中实现灰度发布时的缓存清理,核心做法是利用 `proxy_cache_path` 的 `key` 参数结合请求头或 url 中的版本标识,将不同版本的资源映射到不同的缓存键。当需要清理特定版本的缓存时,通过修改 nginx 配置中的 `cache_key` 或者使用外部脚本配合 `purge` 模块删除对应目录下的文件来实现。这种方法避免了全量清除导致的缓存雪崩,确保只有灰度版本的用户或旧版本资源被精准剔除。

Nginx 缓存失效处理如何配置灰度发布缓存清理

如何根据请求头区分新旧版本缓存

通过设置 `proxy_cache_key` 包含自定义的请求头(如 `X-App-Version`),Nginx 会将带有不同版本号的请求缓存到不同的路径下。这样,新发布的灰度版本流量和旧版本流量的缓存是物理隔离的。配置时需确保上游服务正确传递该头部,并在 Nginx 中定义对应的缓存路径。

Nginx 缓存失效处理如何配置灰度发布缓存清理

server {
    listen 80;
    server_name example.com;

    # 定义缓存路径,使用 $http_x_app_version 作为 key 的一部分
    proxy_cache_path /var/cache/nginx/app levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;

    location /api/ {
        # 设置缓存键,包含版本号
        proxy_cache_key "$scheme$request_method$host$request_uri$http_x_app_version";
        proxy_cache my_cache;
        proxy_cache_valid 200 10m;
        
        # 透传客户端的版本号到后端
        proxy_set_header X-App-Version $http_x_app_version;
        
        proxy_pass http://backend_servers;
    }
}

上述配置中,`proxy_cache_key` 使用了 `$http_x_app_version`。如果客户端发送 `X-App-Version: v1`,缓存键为 `...v1`;若发送 `v2`,缓存键为 `...v2`。两者存储在 `/var/cache/nginx/app/...` 的不同子目录下。这种结构使得后续针对特定版本的清理变得可行,因为我们可以直接定位到包含特定版本哈希值的目录。

Nginx Reverse Proxy
Nginx Reverse Proxy

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

下载

如何通过脚本精准删除指定版本缓存

由于 Nginx 原生不支持按“版本”批量删除缓存,通常采用文件系统操作结合缓存键规则来清理。编写一个 Shell 脚本,根据 `proxy_cache_key` 的生成逻辑,计算出可能存在的缓存文件路径并执行删除。更简单的做法是直接删除包含特定版本标识的目录层级,前提是缓存路径结构清晰且未混用其他无关数据。

Nginx 缓存失效处理如何配置灰度发布缓存清理

#!/bin/bash
# 假设缓存路径为 /var/cache/nginx/app
CACHE_DIR="/var/cache/nginx/app"
VERSION="v1"

# 方法一:如果缓存目录结构严格对应 key 的哈希,可能需要遍历查找
# 但更常见的做法是,如果 key 中包含易识别字符串,可直接操作
# 注意:Nginx 默认 cache key 是 MD5 哈希,直接文件名不可读
# 因此,推荐方案二:使用 purge 模块或应用层通知

# 方法二:应用层触发清理(推荐)
# 在灰度发布系统中,调用 Nginx 的 stub_status 或自定义 API
# 这里模拟一个清理命令,实际生产中常结合 Redis 或消息队列

echo "Cleaning cache for version $VERSION..."
# 实际环境中,可能需要重启 Nginx 或使用 ngx_cache_purge 模块
# 例如:curl http://localhost/purge/$VERSION

在实际操作中,纯文件系统删除风险较高,因为 Nginx 的缓存键通常是哈希值。最稳健的方式是使用 `ngx_cache_purge` 模块。安装该模块后,可以配置一个专门的 `location` 用于接收清理请求。当灰度发布系统决定废弃 `v1` 版本时,它向 Nginx 发送一个包含 `v1` 信息的 HTTP 请求,Nginx 根据配置的规则匹配并删除相关缓存条目。这种方式比直接操作文件系统更安全,且能立即生效,无需等待缓存过期。

灰度切换时如何避免用户访问到脏缓存

在灰度发布切换期间,部分用户可能仍持有旧版本的缓存。为确保平滑过渡,应在灰度策略中设置较短的缓存过期时间(TTL),并在切换瞬间主动触发清理。同时,前端或客户端应支持动态获取版本信息,一旦检测到版本变更,立即清除本地存储并重新请求。服务端侧,可通过修改 `proxy_cache_key` 的前缀或增加随机数后缀,强制刷新所有缓存,但这属于全量清理,仅适用于紧急故障恢复。

热门AI工具

更多
小橡皮AI

一款AI工具,主要用于小橡皮一键去AI味,将机器味重的内容改得更有活人感,防止因为 AI 内容被平台打上 AI 标签,以及限流,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

超级麦吉

一款通过数字员工协作完成调研、数据分析与文档制作的AI办公平台。

相关专题

更多
nginx 重启
nginx 重启

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

443

2023.07.27

nginx 配置详解
nginx 配置详解

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

4427

2023.08.04

nginx配置详解
nginx配置详解

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

7485

2023.08.04

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

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

621

2024.02.23

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

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

1536

2024.07.09

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

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

4018

2024.08.07

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

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

142

2026.01.13

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

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

637

2026.01.13

Navicat创建数据库教程
Navicat创建数据库教程

本专题整理Navicat创建数据库相关教程,介绍新建前的准备、基础设置和创建后的检查方法。内容兼顾入门学习及实际使用需求,帮助用户了解不同数据库类型下的操作差异,为后续建表、保存数据和日常管理提供参考。

0

2026.11.20

热门下载

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

精品课程

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

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn