验证 nginx 模块是否编译成功,最直接的方法是检查 nginx -v 命令输出的配置参数列表,确认目标模块名称出现在 --with-... 或 --add-module=... 之后。如果模块是动态加载的(--with-http_xxx_module=dynamic),还需确保对应的 .so 文件存在于 $prefix/modules/ 目录下,并在配置中通过 load_module 指令正确加载。若模块未出现在 -v 输出中,说明编译时未包含该模块或路径配置有误。

如何确认静态编译的模块已生效
对于静态编译的模块,只需执行 nginx -V 并解析其输出即可确认。该命令会打印出编译时的所有配置选项,只要模块名在列表中,Nginx 启动时就会自动将其链接到主程序中,无需额外操作。

./configure --prefix=/usr/local/nginx --with-http_ssl_module make sudo make install nginx -V 2>&1 | grep http_ssl_module
上述命令执行后,若终端输出包含 --with-http_ssl_module,则证明模块已成功静态编译进二进制文件。注意 nginx -V 的输出默认重定向到标准错误流,因此需要使用 2>&1 进行合并才能被管道捕获。此方法适用于所有通过 --with- 参数编译的内置模块。
如何验证动态模块是否加载成功
动态模块需要额外的步骤来验证。首先,编译时需使用 --add-dynamic-module= 或 --with-http_xxx_module=dynamic 参数。其次,必须在 nginx.conf 的全局上下文(events 块之前)添加 load_module modules/ngx_http_xxx_module.so;。最后,通过 nginx -t 测试配置语法,并使用 nginx -V 查看是否列出了动态模块的路径,或通过 ps aux | grep nginx 观察进程内存中是否加载了相关符号。

# 编译示例 ./configure --prefix=/usr/local/nginx --add-dynamic-module=/path/to/my_module make modules # 配置示例 (nginx.conf) load_module modules/ngx_http_my_module.so; # 验证命令 nginx -t ls -l /usr/local/nginx/modules/ nginx -V 2>&1 | grep my_module
执行 make modules 会生成独立的 .so 文件。运行 nginx -t 时,如果 load_module 指向的文件不存在或格式错误,Nginx 会直接报错退出。若 nginx -V 输出中包含 --add-dynamic-module=/path/to/my_module,且 modules/ 目录下存在对应的 .so 文件,同时 nginx -t 显示 syntax is ok,则表明动态模块已正确集成。


















