SuperAPI AI 工具集

Root Cause Tracing

通用与其它

查看项目

更新于 10-16 02:35

技能介绍

用途:当错误出现在调用栈深处(如 git init 在错误目录执行、文件创建到错误位置、数据库以错误路径打开)时,帮助开发者沿调用链反向追踪,找到最初的触发点,而不是只修复报错处。

主要能力:提供一套回溯流程——观察症状、找到直接原因、追问“谁调用了它”、继续向上追踪、定位原始触发点;并给出在无法手动追踪时添加堆栈日志的做法,例如在危险操作前用 new Error().stack 记录 directory、cwd、NODE_ENV 等信息,测试中用 console.error() 而非 logger,再通过 npm test 2>&1 | grep 'DEBUG git init' 捕获分析。还提供二分查找污染测试的脚本用法:./find-polluter.sh '.git' 'src/**/*.test.ts',逐个运行测试并在首个污染者处停止。

使用方式:先判断错误是否出现在执行深处且可回溯;可回溯则逐层向上,确认源头后在该处修复,并在每一层补充校验形成纵深防御。资料中的示例最终通过将 tempDir 改为在 beforeEach 前访问即抛错的 getter 修复源头,并加入目录校验、非空校验、NODE_ENV 守卫和堆栈日志四层防护。

适用场景:错误发生在非入口点、堆栈显示长调用链、无效数据来源不明、需要确定哪个测试或代码触发问题时。

限制:资料未提供该技能的安装方式、平台支持、收费或价格信息;其效果描述来自一次调试记录(1847 个测试通过、零污染),不代表通用保证。