nginx -s reload 如何处理动态模块重载
执行 nginx -s reload 时,nginx 会触发平滑重载流程,主进程(master)启动新的工作进程(worker),旧的工作进程在处理完当前请求后退出。对于动态加载的模块(.so 文件),新启动的工作进程在初始化时会重新读取配置文件并调用模块的 ngx_addon_dir 路径下的共享库。如果模块代码中实现了 ngx_module_t 结构体的 ctx 指针指向的上下文对象,且该对象包含全局状态或缓存,这些状态会在重载时被重置为初始值。这意味着动态模块的全局内存状态不会保留到新版本进程中,而是从配置文件中定义的默认状态重新开始。

动态模块重载时的内存与状态变化
在重载过程中,动态模块的内存分配器会释放旧工作进程占用的资源,新工作进程则通过 dlopen 机制重新映射模块二进制代码。如果模块内部使用了静态变量或全局单例模式来存储会话数据、连接池或日志句柄,这些数据在重载后会丢失。开发者需要确保模块的状态管理是幂等的,或者在模块的 preconfiguration 和 postconfiguration 阶段重新初始化必要的资源。此外,如果模块依赖外部服务(如 Redis 或数据库),重载期间连接可能会短暂中断,但 Nginx 的主进程保持运行,因此客户端连接不会断开,只是新工作进程建立的连接会使用新的模块实例。

基于 ngx_http_my_module 模块重载后的具体行为
以自定义动态模块 ngx_http_my_module 为例,假设该模块在 create_srv_conf 回调中分配了一个全局计数器用于统计请求数。当执行 nginx -s reload 后,新启动的工作进程会再次调用 create_srv_conf,将计数器重置为零。如果模块需要在重载期间保持计数连续性,必须在模块内部实现持久化机制,例如将计数写入文件或共享内存段。否则,重载会导致统计数据清零。验证这一行为的方法是:在重载前发送一定数量的请求,观察计数器值;重载后再次发送请求,计数器将从零开始递增。这表明动态模块的重载本质上是进程的替换,而非内存状态的迁移。


















