同一段代码报错,AI写的和你手写的,排查路径其实不一样。前者要防的是它自信地编了个不存在的接口,后者多半是你自己哪一格参数填错。很多人一遇到红字就打开编辑器改代码,改到第三版才发现请求根本没发出去。这篇给一套顺序:先确认代码作者是谁,再确认卡在哪一层,最后才决定改哪里。
同一段代码报错,AI写的和你手写的,排查路径其实不一样。前者要防的是它自信地编了个不存在的接口,语法全对、逻辑自洽,跑起来才发现那个函数根本不存在。后者多半是你自己哪一格参数填错,错的位置往往离报错很近。
很多人一遇到红字就打开编辑器改代码,改到第三版才发现请求根本没发出去。这篇给一套顺序:先确认代码作者是谁,再确认卡在哪一层,最后才决定改哪里。前两步花十分钟,能省掉一下午的瞎改。
第一步不是看报错,是看这段代码谁写的
打开报错之前,先翻一眼提交记录或者那段对话记录。这段代码是我自己敲的,还是从对话框里贴过来的,还是两者混着改过的?混着改是最麻烦的情况,你以为在排查一种问题,其实两种代码的毛病叠在一起。
| 代码来源 | 典型出错形态 | 报错出现在 | 先查什么 |
|---|---|---|---|
| AI生成 | 语法正确、逻辑自洽,但调用的东西不存在 | 运行期,而非编辑期 | 函数、接口、包是否真实存在 |
| 手写 | 边界、空值、参数拼错这类局部问题 | 通常离真正的错很近 | 参数填在哪一格 |
| AI生成后自己改过 | 两种毛病叠加,表现不稳定 | 看改的是哪部分 | 先分离两部分,再按来源分别查 |
为什么AI写的代码要单独一套查法?因为它不会告诉你「这里我不确定」。它会用很确定的语气写出一段调用,函数名、参数顺序、返回值都编得像模像样,编辑器不报错,静态检查也过,只有真跑起来才露馅。所以对AI代码,第一步不是读逻辑,是核对它引用的每一个外部名字。
第二步:把「卡住」拆成四层,别一上来就改代码
「跑不通」这三个字信息量太低。同样是不出结果,可能是请求压根没发,可能是发了被拒,可能是回来了但答得不对,也可能是结果不对但流程全对。这四种对应的改法完全不同,对着代码盲改就是碰运气。
- 网络层
- 请求到底有没有发出去;用抓包或日志确认,没发出去的话改代码全是白改
- 协议层
- 地址、鉴权头、字段名对不对;这类错改一行就通,跟业务逻辑无关
- 模型层
- 返回了但答得不对;这时候改的是提示词和输入,不是代码
- 业务层
- 前三层都通了,最后结果不符合预期;这才是真正要读代码的地方
这个顺序的价值在于:越往前层,改起来越便宜。网络层的问题可能只是代理没配,协议层可能只是字段名少了个下划线,一分钟能修好。你要是直接跳到业务层读代码,读半天发现请求根本没到服务器,那种感觉挺难受的。
AI写的代码,按这份清单逐条过一遍
确认是AI生成的之后,别急着逐行读逻辑。先做核对,做完了再谈逻辑。下面这几条按踩坑频率排的,前两条最容易被漏。
- 查它调用的每个函数、类、接口是否真实存在;包名和版本对不对得上,装错版本的包是高频问题,明明文档里有这个方法,你的环境里就是没有
- 查它有没有偷偷加了你没要求的依赖或配置项;跑得通但上线就崩,常常出在这类多出来的东西上
- 查异常处理和边界条件;AI倾向只写正常路径,空值、超时、重试这些分支经常是空的或者写了但没接上
- 查它有没有把示例值当真实值写死,比如占位符地址、假密钥、演示用的模型名,这类问题本地测不出来,一换环境就炸
一个具体的失败经验:装包时看文档写的是新版用法,装上去的是旧版,代码里的方法名存在但参数签名不一样,报错指向的是参数类型,看着像业务逻辑错,顺着想半天。后来把装错的包卸了重装对版本,一行代码没改就好了。所以核对版本这件事,别嫌麻烦。
自己写的代码,反过来查这几处
手写代码出错,问题通常离报错很近,排查反而简单。顺序可以倒过来:先看参数,再看环境,最后才怀疑逻辑。
- 对参数看参数填在哪一格:环境变量、配置文件、命令行参数经常三处对不上。改了一处以为生效了,其实程序读的是另一处。改完用打印或者日志确认读到的是哪个值
- 比环境本地能跑、换台机器就不行,先怀疑环境和代理,别怀疑代码。同一个脚本在同事机器上正常、在你这里报错,八成是网络出口或者依赖版本的事
- 再谈逻辑逻辑错一般表现是稳定复现,每次错在同一个地方。不稳定复现的先去查外部依赖和并发,别对着业务代码使劲
有一种常见误判:看见报错行号就认为错在那行。手写代码里,报错行经常只是「最后崩的地方」,真正的错在向上几行的数据准备阶段。读的时候往前多看两眼,比盯着报错行强。
这套顺序什么时候不适用
这套顺序是给「有时间慢慢查」的场景用的。有三种情况别照着走。
- 线上事故且影响面在扩大时,先止损回滚,再按顺序排查;顺序是排查工具,不是应急流程
- 只有一次性的脚本或实验代码,直接重写比排查便宜,不值得为它拆层
- 报错信息已经把层说死了,比如明确的鉴权失败码,那就跳过前面直接进对应层,别为了走流程绕一圈
说白了,这套顺序解决的是「不知道从哪下手」的问题。你要是已经知道问题在哪一层,直接用对应那层的查法就行。判断标准只有一个:你现在能不能说清请求发出去没有。说不清,就从第一层开始;说得清,就往下走。
下一步想拿真实的接口和模型资料对照着查,可以到站内的模型资料库看各家的调用字段和限制,价格和具体数字以当时页面为准。→常见问题
AI写的代码报错,和手写的排查顺序真的差很多吗?
差在起点。手写代码的报错通常指向真问题附近;AI生成的代码语法往往没问题,错在「它以为存在的东西不存在」,所以要先核对调用目标存不存在,再谈逻辑。顺序反了的话,会在一个本来就对的逻辑里反复改。
怎么快速判断是网络层还是代码层的问题?
看请求有没有真正发出去。抓到包或日志里有请求记录,就是回来的内容有问题,往协议和模型层查;一条记录都没有,问题在发请求之前,先查地址、代理、证书和环境变量,这时候改业务代码没有意义。
团队里要不要给AI生成的代码单独定一套排查规矩?
值得,但别搞成两套流程。更实用的做法是在合并前加一条核对:调用的函数和依赖是否真实存在、有没有多加配置。这条过了,后面的排查路径和手写代码就能共用一套,不用维护两份。