模块损坏本质是ABI不兼容或路径错误，需用nginx -V和readelf比对依赖、nm检查符号表，再用同版本源码重编译模块并nginx -t验证。
模块库损坏通常不是文件“被删”，而是模块与当前 Nginx 二进制不兼容，或 load_module 指令指向了错误路径、错误版本的 .so 文件。修复重点不在“恢复文件”，而在重建匹配关系。
确认模块是否真损坏
执行 nginx -T | grep load_module 查看已声明加载的动态模块路径；再用 ls -l 检查对应文件是否存在、权限是否为可读（如 ngx_http_geoip2_module.so）。若文件存在但 nginx -t 报错 module “xxx” is not binary compatible，说明是版本不匹配，不是损坏。
检查 Nginx 二进制与模块的 ABI 兼容性
动态模块必须与 Nginx 编译时使用的内核头文件、OpenSSL、PCRE 等基础库完全一致。运行：
-
nginx -V记下所有--with-*和--add-module=参数 -
readelf -d /usr/sbin/nginx | grep NEEDED查看依赖的系统库名和版本 -
nm -D /path/to/module.so | head -5确认符号表未截断（异常为空即损坏）
替换或重编译不兼容模块
不要复制他人编译好的 .so 文件。正确做法是：
- 下载与当前
nginx -v版本完全一致的源码包（如nginx-1.28.3.tar.gz） - 在相同操作系统、相同依赖库版本的环境中，用
./configure加上原nginx -V中的全部参数，并额外添加--add-dynamic-module=/path/to/your/module/src -
make modules仅编译模块，生成新的.so文件，覆盖旧文件
验证并启用模块
替换后务必执行：
-
nginx -t—— 确保无unknown directive或not binary compatible错误 -
nginx -T 2>/dev/null | grep -A5 "your_module_name"—— 确认模块配置已载入 -
kill -USR2 $(cat /var/run/nginx.pid) && sleep 1 && kill -WINCH $(cat /var/run/nginx.pid)—— 优雅切换（不中断连接）
