Nginx模块稳定性测试需验证高负载、异常输入、长期运行及配置变更下的行为一致性与容错能力，核心看是否崩溃、内存泄漏、阻塞事件循环或破坏请求链路；关键维度包括进程存活性、内存趋势、请求完整性、热重载兼容性及并发安全性，并辅以基础验证、长稳压测、异常注入等实操方法。
Nginx 模块的稳定性测试不是简单“跑通就行”，而是围绕模块在高负载、异常输入、长期运行和配置变更等真实场景下的行为一致性与容错能力展开。核心目标是验证模块不崩溃、不内存泄漏、不阻塞事件循环、不破坏请求链路。
模块稳定性测试的关键维度
-
进程存活性：Worker 进程在加载模块后是否稳定运行，压测中是否出现
segmentation fault、core dumped或意外退出 -
内存使用趋势：连续运行数小时，
pmap -x $(pidof nginx)或valgrind --tool=memcheck检查是否有持续增长的匿名内存或未释放的堆块 - 请求处理完整性：模块介入的每个请求路径（如 access、content、log 阶段）是否始终返回预期状态码、响应头/体，不丢请求、不卡住连接
-
配置热重载兼容性：执行
nginx -s reload后，模块是否正确释放旧配置、初始化新配置，无句柄残留或逻辑错乱 -
并发安全性：多 worker 同时调用模块共享资源（如全局计数器、缓存结构）时，是否出现竞态、数据错乱（需配合
atomic操作或锁机制验证）
实用测试方法与操作建议
基础功能验证
编写最小化配置 + 简单请求脚本（如curl -I http://127.0.0.1/test），确认模块指令可解析、阶段钩子被触发、日志输出符合预期-
长稳压力测试
使用wrk -t4 -c2000 -d3600 --latency http://127.0.0.1/持续压测 1 小时以上，期间每 5 分钟采集：-
ps aux | grep nginx | grep worker | wc -l（worker 数量是否突变） -
ss -s | grep "estab"（ESTABLISHED 连接数是否缓慢爬升不释放） -
journalctl -u nginx --since "1 hour ago" | grep -i "segment\|abort\|core"（系统级错误）
-
异常输入注入
构造含超长 header、非法 UTF-8、空 body、畸形 query string 的请求，验证模块是否安全 fallback（如返回 400 而非 crash 或 segfault）模块隔离验证
在nginx.conf中仅启用待测模块 + 最小依赖（如仅http { ... }块），关闭access_log、gzip等干扰项，排除第三方模块干扰符号与 ABI 兼容性检查（编译期）
若为自研模块，用nm -D your_module.so | grep "U ngx_"确认所有 nginx 符号引用都存在；升级 Nginx 版本后，务必重新编译模块并做 ABI 兼容性扫描（如abi-compliance-checker）
注意几个易忽略但致命的点
- 模块中若使用
malloc/free但未在ngx_pool_t上分配，容易导致内存管理混乱 - 在
init_worker钩子中启动线程但未设置pthread_detach或未清理，会造成资源泄露 -
ngx_http_finalize_request(r, rc)调用不当（如重复 finalize、在非 content 阶段 finalize），会引发连接状态错乱 - 日志中出现
*xx http request line too large或client sent invalid chunked body时，模块若未正确处理r->request_body状态，可能 hang 住整个 worker
不复杂但容易忽略。
