Nginx平滑重载会导致Lua进程内状态（如模块变量、定时器）丢失，属正常设计；应使用lua_shared_dict持久化关键状态，并避免在init_by_lua*中重复初始化。
平滑重载（nginx -s reload）本身会创建新 worker 进程、逐步淘汰旧进程，但 Lua 脚本的运行状态（比如变量、缓存、计数器）默认是进程内局部的——旧进程退出后，其 Lua 状态自然消失；新进程启动时重新初始化脚本，相当于“重置”。这不是 bug，而是设计行为。排查重点不是“为什么被重置”，而是“哪些状态不该依赖进程生命周期”，以及“如何让关键状态跨 reload 持久化”。
确认是否真由 reload 导致状态丢失
先排除其他干扰因素：
- 检查是否误用了
init_by_lua*或set_by_lua*中的全局变量（如local count = 0放在模块顶层），这类变量每次 Lua 文件被 require 时都会重置，和 reload 无关，而是 Lua 模块加载机制导致 - 观察日志中
init_by_lua_block是否在每次 reload 后重复执行（可通过ngx.log(ngx.INFO, "init run at ", ngx.time())验证），若重复出现，说明脚本确被重新加载 - 对比 reload 前后共享字典（
lua_shared_dict）中的值：如果共享字典内容没变，但业务逻辑表现异常，问题大概率出在非共享状态上
识别易被重置的 Lua 状态类型
以下几类数据在 reload 后必然丢失，需特别注意：
-
模块级 local 变量：如在
my_module.lua文件顶部写local cache = {}，每次 reload 后该 table 为空 - ngx.ctx 数据：仅对单次请求生命周期有效，reload 不影响它，但常被误认为“状态”，实际它本就不跨请求
-
未持久化的定时器回调：用
ngx.timer.at创建的定时器，在旧 worker 退出时自动失效，新 worker 需重新注册 -
require 缓存外的全局表：如直接写
package.loaded["my_mod"] = nil后又require，会触发重新加载，状态清空
用共享字典（shared dict）替代进程内状态
这是最常用且可靠的跨 reload 持久化手段：
- 在
http块中定义：lua_shared_dict my_state 2m; - 所有需要长期保存的状态（如熔断计数、限流窗口、配置版本戳）都通过
dict:get/dict:set存取，不存本地变量 - 注意：shared dict 是内存级、worker 共享的，无需额外同步；但读写操作要加锁（用
dict:incr或dict:lpush等原子操作）避免竞态 - 示例：降级开关状态不应存在
local is_degraded = false，而应查shdict:get("degrade_flag") == "on"
避免 reload 依赖的初始化逻辑
有些初始化只需做一次（如连接 Redis、加载证书），不应放在 init_by_lua_block 中反复执行：
- 把一次性初始化移到
init_worker_by_lua_block，并用 shared dict 标记是否已完成（如shdict:add("init_done", true)） - 或改用 lazy-init：首次使用时检查并初始化，后续直接复用已建立的连接/对象
- 对配置类数据，推荐用外部配置中心 + 定时拉取（如每 5 秒
http.request获取 JSON），而非靠 reload 推送
