Ngx Lua中init_by_lua_block初始化的局部变量作用域与生命周期疑问

我是Nginx Lua新手，接手了前任开发者的代码。查阅文档后仍对变量作用域存疑，现有代码如下：

Nginx配置中的代码：

init_by_lua_block {
    my_module = require 'my_module'
    my_module.load_data()
}


location / {
    content_by_lua_block {
        my_module.use_data()
    }
}

my_module.lua中的代码：

local _M = {}
local content = {}

function _M.use_data()
    -- 访问content变量
end

function _M.load_data()
    -- 将JSON数据加载到content变量的代码
end

return _M

我原本认为content是局部变量，生命周期仅在单个请求内，但它在init_by_lua_block中初始化并被其他函数调用，对此我感到困惑：这种实现是否为良好实践？content变量的实际生命周期是什么？

先搞清楚content变量的实际生命周期 #

你之前的理解有偏差，这个content并不是单个请求级别的变量，而是模块级的局部变量，它的生命周期和Nginx的worker进程绑定：

• init_by_lua_block是在Nginx worker进程启动（或者执行nginx -s reload）时执行的，每个worker进程只会执行一次这个块里的代码。
• 当你require 'my_module'时，模块里的代码会被执行一次，创建出local content这个变量，它属于模块的闭包范围——也就是说，这个变量会一直保存在当前worker进程的内存中，直到worker进程退出或者Nginx被reload。
• 后续所有请求进入location /的content_by_lua_block时，调用my_module.use_data()访问的都是同一个worker进程里的content变量，不会每个请求重新创建。

这种实现算不算良好实践？得分情况看 #

适合的场景：

• 如果content里存的是不经常变化的静态数据（比如配置项、固定的字典映射），这种方式非常高效：数据只在worker启动时加载一次，后续所有请求直接复用，避免了重复读取文件或者数据库的开销。
• 模块级局部变量的访问速度很快，而且因为每个worker进程有自己的一份副本，不存在跨worker的竞争问题（只要你不修改它）。

需要注意的问题：

1. 数据更新麻烦：如果需要更新content里的数据，必须重启或者reload Nginx，因为数据是在worker启动时加载的，运行时无法动态更新（除非你在模块里写了重新加载的逻辑，但也要注意线程安全）。
2. 内存占用：如果content的数据量很大，每个worker进程都会占用一份内存，可能会导致worker内存占用过高，需要根据实际情况评估。
3. 线程安全风险：如果你的代码里有修改content的逻辑（比如在use_data里修改它），虽然Nginx Lua是单请求单线程处理，但如果有异步操作（比如ngx.timer.at）或者跨请求的修改，可能会出现数据不一致的问题，这种情况要谨慎处理。

如果你的场景需要动态更新数据，或者数据需要在多个worker进程间共享，那更推荐使用Nginx提供的ngx.shared.DICT（共享内存字典）来存储数据，它支持跨worker共享，并且可以在运行时动态修改。

内容的提问来源于stack exchange，提问作者Luan Nguyen