验证nginx动态模块功能需分三层：先用nginx -t确认加载成功（排除路径、abi、依赖问题）；再检查http/server块中是否启用对应指令（如brotli on;）；最后发起真实请求并观察响应头、body或error.log调试日志。
测试新加载的 Nginx 动态模块功能是否正常，不能只看模块“加载成功”，而要分两层验证：一是确认模块被正确加载（语法与路径无误），二是确认模块功能在运行时真正启用并响应请求。两者缺一不可。
第一步：用 nginx -t 验证模块是否加载成功
这是最基础、最关键的一步。只有通过这步，才能排除路径错误、文件缺失、ABI 不兼容等硬性问题：
- 执行 nginx -t —— 若输出 "syntax is ok"，说明所有
load_module指令指向的.so文件已由dlopen()成功载入； - 若报错，如
dlopen() failed或undefined symbol，说明模块文件不可读、路径写错、架构/版本不匹配，或依赖库（如 libssl、libpcre）缺失； - 注意：
nginx -V不会列出动态模块，它只显示静态编译进二进制的模块，不可用于此验证。
第二步：检查配置中是否启用模块对应的功能指令
加载 ≠ 启用。很多动态模块需在 http、server 或 location 块中显式配置指令，功能才生效：
- 例如
ngx_http_brotli_filter_module加载后，必须在http或server块中写brotli on;才压缩响应； - 再如
ngx_http_geoip2_module，需配置geoip2 /path/to/GeoLite2-City.mmdb { ... }并在location中使用$geoip2_data_country_code变量； - 如果配置里没写任何该模块要求的指令，
nginx -t仍会通过，但实际请求中完全无效果。
第三步：发起真实请求 + 查看响应或日志
这是最终确认功能落地的方式，需结合模块行为设计简单测试点：
- 对压缩类模块（如 Brotli、Gzip），用
curl -H "Accept-Encoding: br" -I http://your.site/查响应头是否含Content-Encoding: br； - 对 GeoIP 类模块，用不同地区出口 IP 访问，检查响应头或 body 中是否返回预期地理位置变量值；
- 对
ngx_http_echo_module，配置echo "hello";，访问对应 location 看是否返回字符串； - 开启
error_log /var/log/nginx/error.log debug;（临时），可捕获模块初始化或处理阶段的调试信息（需模块本身支持 debug 日志）。
补充：快速定位常见失效原因
功能看似没反应？优先排查这几项：
-
模块被加载，但配置位置错：比如把
brotli on;写在了events块里，Nginx 会静默忽略； -
reload 未执行：改完
nginx.conf后只运行了nginx -t，忘了nginx -s reload； -
worker 进程权限不足：模块文件属主为 root，但 worker 以
www-data身份运行且无读权限，nginx -t可能不报错（root 用户执行时有权限），但 reload 后 worker 加载失败； -
模块依赖其他动态模块：如某模块需
stream模块支持，但load_module未声明或顺序颠倒，可能引发运行时报错。
