配置多站点缓存失效的核心做法是定义一个包含所有站点域名或路径的映射表,并在 nginx 中通过 `map` 指令将其与特定的缓存键或清除逻辑关联。当需要失效时,利用 `proxy_cache_purge` 模块(如 `ngx_cache_purge`)或自定义 lua 脚本,根据请求中的标识符匹配该映射表,从而精准删除对应站点的缓存文件。这种方法避免了为每个站点单独编写复杂的清理规则,实现了集中管理和批量控制。

如何定义多站点的缓存映射关系
要实现多站点缓存失效,第一步是建立站点标识与缓存目录或键值的映射。在 Nginx 配置文件中,使用 map 指令创建一个变量,将不同的 $host 或 $uri 映射到唯一的缓存前缀。例如,可以将 site_a.com 映射到 cache_a,将 site_b.com 映射到 cache_b。这样,后续的缓存操作就可以基于这个映射后的变量进行,确保不同站点的缓存互不干扰且易于定位。

http {
# 定义站点标识到缓存前缀的映射
map $host $cache_prefix {
default "default";
site_a.com "cache_a";
site_b.com "cache_b";
}
# 设置缓存路径,使用前缀区分
proxy_cache_path /var/cache/nginx/levels=1:2 keys_zone=my_cache:10m max_size=1g inactive=60m use_temp_path=off;
server {
listen 80;
server_name site_a.com site_b.com;
location / {
# 使用动态缓存键,结合站点前缀
proxy_cache_key "$scheme$request_method$host$cache_prefix$request_uri";
proxy_cache my_cache;
proxy_pass http://backend;
}
}
}
上述配置中,$cache_prefix 变量根据 $host 的值动态变化。在 location 块中,proxy_cache_key 包含了 $cache_prefix,这意味着即使两个站点访问相同的路径 /index.html,它们在缓存中的键值也是不同的,因为前缀不同。这为后续精准失效奠定了基础。
如何实现基于映射的缓存清除接口
定义了映射后,第二步是实现能够识别这些映射并执行清除操作的接口。通常使用 ngx_cache_purge 模块提供的 proxy_cache_purge 指令。为了支持多站点,需要在清除请求中传递站点标识,或者在 URL 结构中体现站点信息。例如,可以设计一个专门的清除端点 /purge,要求请求头或参数中包含目标站点信息,然后在 Nginx 内部通过 if 或 map 解析出对应的缓存键,再调用清除逻辑。另一种更简单的方式是利用 proxy_cache_purge 对特定 URL 模式的匹配能力,直接针对包含站点前缀的 URL 进行清除。

server {
listen 80;
server_name site_a.com site_b.com;
# 假设 ngx_cache_purge 已加载
location /purge/ {
# 允许特定 IP 访问清除接口
allow 192.168.1.100;
deny all;
# 提取 URL 中的站点标识,例如 /purge/site_a.com/path
set $purge_host $arg_host;
if ($uri ~ ^/purge/(.+?)/(.+)) {
set $purge_host $1;
set $purge_path $2;
}
# 构建用于清除的完整缓存键
# 注意:这里需要根据实际的 proxy_cache_key 构造方式调整
# 假设 cache_key 格式为: scheme method host prefix uri
set $purge_key "$scheme$request_method$purge_host$cache_prefix$purge_path";
# 执行清除
proxy_cache_purge my_cache $purge_key;
}
location / {
proxy_cache_key "$scheme$request_method$host$cache_prefix$request_uri";
proxy_cache my_cache;
proxy_pass http://backend;
}
}
在这个示例中,清除接口 /purge/ 接收 URL 参数或路径部分来指定目标站点和路径。通过正则表达式提取站点名和路径,然后重构出与缓存存储时完全一致的 $purge_key。调用 proxy_cache_purge 时传入这个键,Nginx 就会去缓存目录中查找并删除对应的文件。这种方式允许管理员通过访问 /purge/site_a.com/index.html 来专门清除 site_a.com 的首页缓存,而不会影响其他站点。
如何处理缓存键冲突导致的误删问题
在多站点缓存失效场景中,一个常见的问题是缓存键冲突。如果不同站点的缓存键生成策略不够唯一,可能会导致清除一个站点的缓存时,意外删除了另一个站点具有相同键值的缓存。例如,如果 proxy_cache_key 仅包含 $request_uri 而不包含主机名或站点前缀,那么 site_a.com/page 和 site_b.com/page 可能会共享同一个缓存条目。在这种情况下,清除 /page 会同时影响两个站点。因此,必须确保缓存键的全局唯一性,通常通过将 $host 或前面定义的 $cache_prefix 纳入 proxy_cache_key 来解决。此外,在实现清除接口时,也要严格验证输入的站点标识,防止恶意用户通过构造特殊的 $purge_key 来清除非预期的缓存数据。











