验证新编译模块是否真正生效需分层实测：先用nginx -v确认configure参数与依赖路径正确；再用nginx -t测试模块指令是否被识别；最后启动服务，通过curl请求和error.log日志验证运行时行为与初始化是否正常。
验证新编译模块是否真正生效且功能正常，不能只看 nginx -V 里有没有参数——它只说明“编译时声明了”，不等于“运行时加载了、初始化了、能用了”。必须分层实测：从模块注册、指令识别、配置加载，到真实请求触发行为。
确认模块已静态链接并注册成功
执行 ./nginx -V，重点检查两处：
-
configure arguments 行中是否完整出现你的模块路径（如
--add-module=../ngx_http_echo_module）； - built by 和 built with 是否显示模块依赖的头文件/库已就位（例如 echo 模块依赖 PCRE，若缺失则 configure 阶段会跳过）。
若参数存在但模块仍不可用，大概率是 configure 时未报错但实际未启用——常见于模块 config 文件缺失、MODULE_TYPE 声明错误，或路径拼写有误（如多一个空格、大小写不符）。
测试模块指令能否被配置解析器识别
在 nginx.conf 的 server 或 location 块中，添加该模块提供的典型指令，例如：
- echo 模块：
echo "hello from module"; - headers-more 模块：
more_set_headers "X-Module-Loaded: yes"; - lua 模块：
content_by_lua_block { ngx.say("lua ok") }
然后运行 ./nginx -t。若报 unknown directive "echo" 或类似错误，说明模块未被正确注册进 Nginx 指令表——此时即使二进制存在，模块也形同虚设。
启动服务并验证运行时行为
配置通过后，启动 Nginx 并发起真实请求：
- 用
curl -I http://localhost查看响应头是否含你设置的自定义 Header； - 用
curl http://localhost检查响应体是否输出预期内容（如 echo 或 lua 返回）； - 若模块涉及 upstream（如 health-check），可查看
nginx -T | grep -A5 "upstream"确认健康检查指令是否出现在展开后的完整配置中。
注意：某些模块（如 cache-purge）需配合特定 HTTP 方法（PURGE）才能触发，要确保 client 请求方法与模块逻辑匹配，且未被 limit_except 等限制拦截。
检查日志与错误反馈
模块初始化失败通常不会导致 Nginx 启动失败，但会在 error.log 中留下线索：
- 搜索
module、init、failed等关键词； - 常见错误如
could not build the server_names_hash（模块修改了核心结构但未调用 hash 初始化）、shared memory zone ... is unknown（模块申请的共享内存未被主进程创建）； - 若模块依赖外部库（如 LuaJIT、GeoIP2），还要确认
ldd ./nginx | grep -i luajit是否显示动态链接正常。
