SuperAPI AI 工具集

debugging-strategies

编程与开发

查看项目

更新于 10-16 06:15

技能介绍

用途:提供系统化的缺陷排查方法,适用于定位与修复程序错误、性能退化、内存泄漏和网络连接问题。

主要能力与用法: 堆栈跟踪分析——自底向上阅读跟踪,起点是最新调用;可用 NODE_OPTIONS="--stack-trace-limit=50" node app.js 获取完整 Node.js 堆栈,python3 -u -X tracemalloc app.py 输出详细回溯。常见模式:TypeError 属未定义属性时检查链路上层对象;ECONNREFUSED 多为服务未启动或端口错误;ENOMEM 提示内存耗尽;Segfault 指向原生扩展或缓冲区溢出。 日志诊断——tail -f app.log | grep -E "ERROR|WARN" 实时过滤;grep -n "error" app.log | tail -20 搜近期日志;grep "req-abc123" app.log 按请求 ID 关联;容器用 docker logs --since 5m --follow myapp 2>&1 | grep -i error,Kubernetes 用 kubectl logs -l app=myapp --since=10m | grep -i "exception|error|fatal",多 Pod 加 --all-containers --prefix。 Git 二分定位——git bisect start、git bisect bad、git bisect good v1.0.0,测试每个检出提交后标记 good/bad,可用 git bisect run npm test 自动化,结束用 git bisect reset,查看记录用 git bisect log。 内存泄漏检测——Node.js 可用 node --inspect app.js 在 chrome://inspect 取堆快照并比对,或定时打印 process.memoryUsage 的 rss/heap/external,OOM 时用 node --max-old-space-size=512 --heap-prof app.js 生成堆转储;Python 可用 tracemalloc 统计前 10 行,或用 objgraph.show_most_common_types(limit=10) 查引用环。 网络排查——dig example.com +short、nslookup 检查 DNS;nc -zv localhost 3000 验端口;curl 用 -w 输出 DNS、Connect、TTFB、Total 计时;lsof -i :3000 或 netstat -an | grep 3000 观察连接。 复现与隔离——建最小用例并逐步删代码直到缺陷消失,最后一步删除处即嫌疑点;对比 node --version、npm --version 与 uname -s 等环境变量;用循环多次运行测试排查竞态条件。

限制与注意事项:先复现再修复,无法复现就无法验证修复;内存泄漏表现为 RSS 随时间上升,需间隔取快照对比;git bisect run 常被低估,可自动定位破坏提交;卡住时向他人复述问题(橡皮鸭调试);先检查最明显的问题,如服务是否运行、环境变量是否设置、配置是否正确。除上述命令与思路外,其他工具细节暂未提供。