SuperAPI AI 工具集

nginx-c-module-debugging

编程与开发

查看项目

更新于 10-16 03:46

技能介绍

用途:在调试 nginx C 模块崩溃、内存缺陷与行为异常时提供系统化诊断指南。资料称该技能基于 nginx 官方开发文档与生产调试经验,包含 8 个类别、45 条规则,并按影响程度划分优先级。

主要能力按优先级分为八类:一、崩溃诊断与信号(crash-,CRITICAL),如从信号与地址识别段错误特征、识别空指针解引用、诊断重复 finalize、检测递归子请求或过滤链导致的栈溢出、从 worker 退出日志提取崩溃上下文、避免 error_page 内部重定向上下文失效引发的崩溃。二、内存缺陷检测(memdbg-,CRITICAL),如池销毁时机导致的释放后使用、池泄漏、多 worker 崩溃中的共享内存 slab 损坏、缺失清理处理器导致的资源泄漏、ngx_pnalloc 大小算错的缓冲区越界、临时池误用、用 Valgrind 池级追踪查找泄漏分配。三、GDB 与核心转储分析(gdb-,HIGH),如配置核心转储、附加 GDB 到运行中的 worker、读回溯定位模块与阶段、检查请求结构、用脚本从内存缓冲区提取调试日志、用观察点捕捉写入时内存损坏。四、请求流追踪(trace-,HIGH),涵盖阶段处理器、子请求树、过滤链顺序、上游回调序列、事件处理器链与配置继承。五、调试日志模式(dbglog-,MEDIUM-HIGH),含调试掩码、debug_connection、内存缓冲区日志、日志动作字符串与 ngx_str_t 格式化。六、状态与生命周期调试(state-,MEDIUM),含连接状态、上游状态机、定时器泄漏、事件标志、请求引用计数。七、动态追踪工具(probe-,MEDIUM),含 strace、DTrace pid 提供者、SystemTap、eBPF 延迟测量与文件描述符泄漏检测。八、构建与 Sanitizer 配置(build-,LOW-MEDIUM),含调试符号编译、AddressSanitizer、单进程模式、Valgrind 抑制文件与 NGX_DEBUG_PALLOC。

使用方式:资料称需阅读各参考文件获取详细说明与代码示例,参考文件包括 references/_sections.md(类别定义与排序)与 assets/templates/_template.md(新规则模板)。

限制:该技能定位为调试与诊断,与正确性技能 nginx-c-module-best-practices、性能可靠性技能 nginx-c-module-perf-reliability 互补;具体安装命令、收费与平台支持信息暂未提供。