报错排查 · 程序员
用 AI 智能体做这件事
同一段报错,操作系统、运行时版本、日志完整度不同,结论会差很远。这个场景先声明运行系统与环境和完整日志,再按可能性从高到低列出排查步骤,每一步说清要看什么、怎么验证,最后给修复方法。生产日志含用户数据,务必先脱敏;没给全的堆栈会标【待补】。
你需要准备
- 运行系统与环境:操作系统、运行时与框架版本、依赖清单
- 完整错误日志与堆栈(没贴全的先标【待补】)
- 复现步骤或触发条件(什么入参、什么时候必现)
- 相关代码片段或配置文件
- 代码托管平台(GitHub / GitLab / 内部仓库),便于对照分支与版本
怎么做
- 先声明运行系统、环境与版本
- 若日志或配置含密钥、token、连接串或真实用户数据,先脱敏
- 贴完整日志、复现步骤与相关代码,粘贴提示词
- 逐条验证排查步骤,核对【待补】项后再改代码
一句话提示词
我运行【程序/命令】时报了下面这个错误,运行系统与环境(操作系统、运行时 / 框架版本)和完整错误日志我先声明并贴给你,帮我分析最可能的原因,按可能性从高到低列出排查步骤,每一步说明要看什么、怎么验证,最后给出修复方法和需要改动的代码;日志里脱敏掉的信息或没贴全的堆栈请标【待补】,不要编造。
它会交付什么
- 最可能的原因(按可能性从高到低排序,属 AI 推测,需人工判断)
- 排查步骤:每一步要看什么、怎么验证(属 AI 推测,需人工判断)
- 修复方法与需要改动的代码
效果示例
输入一段 Django 报「ModuleNotFoundError」的堆栈 + 依赖清单 → 输出按可能性排序的排查步骤;虚拟环境版本未给,标【待补】。(原因属推测,需人工判断)
常见问题
只给报错那一行够吗?
不够。完整堆栈能定位到具体文件和调用链,只给一行多数只能猜,缺的会标【待补】。
生产日志里带用户数据怎么办?
先脱敏(去掉手机号、身份证、token 等)再发,这是前置步骤。
它给的原因可信吗?
按可能性排序只是推测,需人工判断;请照排查步骤逐条验证。
改了代码一定能修好吗?
不一定,先按步骤验证根因再定改法,改完要回归测试。