在 linux 中,nginx 结合 lua 脚本实现缓存动态刷新的核心做法是:利用 nginx 的 `proxy_cache` 模块存储静态或半静态内容,并通过 lua 脚本(通常基于 openresty)拦截特定的管理请求。当需要刷新时,lua 代码直接调用 nginx 内部 api 删除对应的缓存文件键值,或者通过发送带特定 header 的请求触发后端重新生成内容并更新缓存。这种方法避免了重启 nginx 服务,实现了毫秒级的缓存失效。

如何通过 Lua 脚本删除指定 URL 的缓存文件
要实现针对特定 URL 的缓存删除,关键在于获取该 URL 在缓存系统中的 Key,并调用 Nginx 的底层文件系统接口进行物理删除。在 OpenResty 环境中,可以使用 `ngx.shared.DICT` 来辅助管理元数据,但更直接的方式是利用 `ngx.location.capture` 模拟请求或使用 `os.execute` 调用系统命令清理缓存目录。然而,最优雅且高性能的做法是使用 `lua-resty-core` 提供的缓存操作接口,或者编写一个自定义的 Lua 函数,根据 URL 生成与 Nginx 缓存一致的 Key,然后使用 `ngx.log` 记录日志并配合外部脚本或内部 API 删除文件。这里我们展示一种基于 `ngx.shared` 标记和文件删除的组合策略,确保缓存一致性。

-- 假设这是一个处理缓存删除请求的 Lua 脚本片段
-- 配置 nginx.conf 中需包含: lua_shared_dict cache_meta 10m;
local function purge_cache(url)
-- 1. 生成与 proxy_cache_key 一致的哈希值
-- 假设 proxy_cache_key 为 $scheme$proxy_host$request_uri
local key_hash = ngx.md5(ngx.var.scheme .. ngx.var.host .. url)
-- 2. 记录删除动作到共享字典,供其他 worker 同步或审计
local cache_meta = ngx.shared.cache_meta
cache_meta:set("purge_" .. key_hash, "1", 60) -- 保留60秒
-- 3. 实际删除缓存文件
-- 注意:直接操作 Nginx 缓存目录需要谨慎,确保路径正确
-- 这里演示概念,实际生产中建议使用 lua-resty-cache-purge 或类似模块
local cache_path = "/var/cache/nginx/proxy_temp/" .. string.sub(key_hash, 1, 2) .. "/"
local file_name = key_hash
-- 使用 os.execute 调用 rm 命令 (生产环境建议封装为独立 C 模块或 API)
local cmd = "rm -f " .. cache_path .. file_name
local ret = os.execute(cmd)
if ret == 0 then
ngx.say("Cache purged for: " .. url)
else
ngx.status = 500
ngx.say("Failed to purge cache")
end
end
-- 在 location 块中调用
-- if ngx.var.arg_purge == "1" then
-- purge_cache(ngx.var.uri)
-- return
-- end
上述代码展示了如何根据 URL 计算 MD5 哈希值,这与 Nginx `proxy_cache_key` 的计算方式一致。通过 `os.execute` 删除对应的缓存文件,实现了精准的缓存失效。需要注意的是,直接操作文件系统在高并发下可能存在竞争条件,因此引入 `ngx.shared.DICT` 作为元数据锁或状态标记是一种常见优化手段。运行此脚本前,需确保 Nginx 用户有权限访问 `/var/cache/nginx` 目录。
如何利用 Lua 脚本实现基于标签的批量缓存刷新
除了单 URL 刷新,实际业务中常需要根据“标签”或“资源组”批量刷新缓存。例如,当某个商品分类下的所有商品详情页都需要更新时,逐个删除 URL 效率极低。解决方案是在响应头中注入自定义标签(如 `X-Cache-Tags: product_123, category_456`),并在 Lua 脚本中解析这些标签,维护一个从标签到 URL 列表的映射关系。当收到批量刷新请求时,Lua 脚本遍历该映射,逐一触发对应 URL 的缓存删除逻辑。

-- 批量缓存刷新 Lua 脚本示例
-- 依赖: lua-resty-redis (用于存储标签与URL的映射)
local redis = require "resty.redis"
local function get_urls_by_tag(tag)
local red = redis:new()
red:set_timeout(1000)
local ok, err = red:connect("127.0.0.1", 6379)
if not ok then
ngx.log(ngx.ERR, "failed to connect Redis: ", err)
return {}
end
-- 获取与该标签关联的所有 URL
local urls, err = red:smembers("cache_tags:" .. tag)
if not urls then
ngx.log(ngx.ERR, "failed to get urls for tag: ", err)
return {}
end
red:set_keepalive(10000, 100)
return urls or {}
end
local function batch_purge(tag)
local urls = get_urls_by_tag(tag)
local results = {}
for _, url in ipairs(urls) do
-- 复用之前的单 URL 删除逻辑
local key_hash = ngx.md5(ngx.var.scheme .. ngx.var.host .. url)
local cache_path = "/var/cache/nginx/proxy_temp/" .. string.sub(key_hash, 1, 2) .. "/"
local cmd = "rm -f " .. cache_path .. key_hash
os.execute(cmd)
table.insert(results, url)
end
ngx.say("Purged tags: " .. tag .. ", count: " .. #results)
end
-- 在管理接口中调用
-- if ngx.var.arg_tag then
-- batch_purge(ngx.var.arg_tag)
-- return
-- end
该方案通过 Redis 作为标签与 URL 的索引中心,实现了高效的批量缓存管理。当后端发布新内容时,可以在响应头中设置 `X-Cache-Tags`,Lua 脚本在 `header_filter_by_lua_block` 中捕获这些标签并存入 Redis。当管理员请求刷新某个标签时,脚本快速检索所有相关 URL 并执行删除操作。这种方式扩展性强,适用于大型电商或内容管理系统。
当 Lua 脚本删除缓存后,Nginx 如何处理后续请求以确保证据一致性
在 Lua 脚本成功删除缓存文件后,下一个到达的客户端请求将面临缓存未命中(Cache Miss)。此时,Nginx 会将请求转发给后端服务器(Upstream),获取最新内容,并将其重新存入缓存目录。这个过程确保了用户看到的是最新数据。关键在于,删除操作必须发生在响应返回之前,且删除的文件名必须与即将生成的新缓存文件名完全一致。如果存在并发请求,即在删除瞬间有多个请求同时到达,Nginx 的 `proxy_cache` 模块通常具备防击穿机制(如 `proxy_cache_lock`),确保只有一个请求去后端拉取数据,其他请求等待或返回旧缓存(取决于配置)。但在本例中,由于文件已被物理删除,所有后续请求都会触发回源。为了验证这一过程,我们可以观察 Nginx 的错误日志,确认是否有 `upstream` 请求的记录,以及缓存目录中是否生成了新的哈希文件。这种机制保证了缓存的动态性和一致性,无需人工干预即可自动恢复最新状态。











