Linux 中 Nginx 缓存失效处理怎么结合 Lua 脚本实现动态刷新

星敏君_8306

星敏君_8306

2026-11-16

697人浏览

原创

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

Linux 中 Nginx 缓存失效处理怎么结合 Lua 脚本实现动态刷新

如何通过 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` 标记和文件删除的组合策略,确保缓存一致性。

Linux 中 Nginx 缓存失效处理怎么结合 Lua 脚本实现动态刷新

-- 假设这是一个处理缓存删除请求的 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 的缓存删除逻辑。

Linux DO
Linux DO

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

下载

Linux 中 Nginx 缓存失效处理怎么结合 Lua 脚本实现动态刷新

-- 批量缓存刷新 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` 请求的记录,以及缓存目录中是否生成了新的哈希文件。这种机制保证了缓存的动态性和一致性,无需人工干预即可自动恢复最新状态。

相关文章

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

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

下载

相关标签:

linux nginx nginx 缓存

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

相关专题

更多
nginx 重启
nginx 重启

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

2023.07.27

423

5

nginx 配置详解
nginx 配置详解

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

2023.08.04

4287

6

nginx配置详解
nginx配置详解

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

2023.08.04

7205

6

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

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

2024.02.23

601

5

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

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

2024.07.09

1516

5

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

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

2024.08.07

3998

3

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

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

2026.01.13

122

12

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

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

2026.01.13

597

23

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

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

2026.03.16

179

12

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习

Buffalo框架快速入门指南
Buffalo框架快速入门指南

共0课时 | 0人学习

Valgrind支持平台说明
Valgrind支持平台说明

共0课时 | 0人学习