AI 生成的网站上线后报接口错误,最常见的处理是把整段代码丢回去重新生成。偶尔碰对,多数时候会把本来正常的页面一起改坏,还失去对问题的判断。更省时间的办法只有一个:先用现象把错误压到某一层,再只改那一层。
一次请求从点击到数据上屏会经过前端代码、HTTP 请求、网关与后端、数据库与缓存、响应渲染五段。判断缺陷属于前端还是后端,网络请求分析是最通用的方法,日志与模拟请求用于确认。
| 层级 | 典型现象 | 证据看哪里 | 优先动作 |
|---|---|---|---|
| 前端 / 浏览器 | 白屏、点击无反应、样式错乱 | Console、Network 响应体 | 修事件绑定与渲染 |
| 接口契约 | 参数名对不上、路径不一致 | 请求体、接口文档 | 对齐字段与结构 |
| 后端 / 网关 | 5xx、鉴权失败、响应慢 | 服务端日志、traceId | 修逻辑、鉴权、超时 |
| 数据库 / 缓存 | 返回空数组、写入没生效 | 手工执行同参数查询 | 修 SQL、索引、权限 |
| 环境与配置 | 本地正常、线上报错 | 环境变量与部署日志 | 修变量、域名、跨域 |
30 秒分流:五个问题砍掉一半范围
打开工具前先回答五个是非题,每个答案都能砍掉一半排查空间。
- 页面能打开吗?打不开看前端或运行环境;能打开但没数据,问题已在接口或数据一侧。
- 请求真的发出去了吗?点击后 Network 没有新请求,基本锁定前端:事件没绑定、校验拦截、JS 报错中断。
- 状态码是多少?4xx 是请求本身有问题,5xx 是服务端处理出错。
- curl 重发同一请求还失败吗?一样失败在后端,curl 成功而页面失败几乎总在前端或浏览器环境。
- 数据库里有这条记录吗?页面提示成功不代表写入成功。
先复现、再分层、一次只改一个变量,这个顺序比工具是否高级更影响效率。
Console:判断请求有没有离开浏览器

Console 是第一站,它是唯一能告诉你「JS 在请求发出前就崩了」的地方。看三类信息:红色未捕获异常,Uncaught TypeError 出现后代码不再继续执行;CORS 拦截,浏览器拿到了响应却拒绝交给你的代码,问题常在服务端响应头或代理配置;资源 404,看着像「样式乱了」,其实与接口无关。
取证靠日志,不靠猜:
const reqId = crypto.randomUUID();
const res = await fetch('/api/leads', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify(payload),
});
const data = await res.json().catch(() => null);
console.log('[submit]', reqId, res.status, data);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
Network:请求对不对、响应有没有被正确处理
Network 同时回答四件事:请求发了吗、地址与方法对吗、状态码多少、响应体长什么样。顺序是先按 Fetch/XHR 过滤确认请求存在,再核对 URL、方法与 Content-Type,然后看 Payload 的字段名、类型与必填项,最后看 Response 结构是否与前端取值路径一致。
三种结论覆盖八成情况:没有请求,问题在前端触发逻辑;有请求但参数不对,问题在参数组装或契约不一致;请求和参数都对但渲染不对,问题在字段映射。
还有一个易漏项是缓存:接口返回新数据,CDN 或 Service Worker 却一直给旧响应,先用带随机查询参数的地址验证一次,再决定要不要读代码。
状态码速查:400、401、403、404、500 指向哪里
| 状态码 | 含义 | 优先怀疑 |
|---|---|---|
| 400 | 参数或格式不合法 | 前端传参、后端校验 |
| 401 | 未认证或凭证无效 | Token 缺失、过期、格式错 |
| 403 | 已认证但无权限 | 角色权限、跨域策略 |
| 404 | 资源不存在 | 路径、baseURL、网关转发规则 |
| 500 | 服务端内部错误 | 后端异常,或前端传了脏数据 |
| 502 / 504 | 网关拿不到响应 / 超时 | 进程挂了、慢查询、网关超时 |
404 不一定是前端写错路径,也可能是网关少了一条转发规则;500 不一定是后端全责,前端传 null 或多余字段同样能把服务端打挂;CORS 报错看着像前端,实际常常要改服务端响应头。
后端与数据库:用请求标识和手工查询倒推

确认问题在后端一侧后,不要从代码第一行读起。拿时间点和请求标识去日志里定位,用 traceId 检索能把一条请求在中间件、控制器、服务层的轨迹串起来,链路上第一个报错才是真因。
几分钟搭建展示站并增长获客
输入一句想法,We0 AI 即可生成展示站、页面与 CMS。发布上线后并帮你获取客户和流量。
用户注册赠送一次完整项目生成
适合先体验一次完整生成流程,快速看到项目初稿。
数据库层三个动作就够:手工执行可疑查询,参数与线上完全一致;对慢查询做 EXPLAIN ANALYZE,全表扫描是「接口时快时慢」的头号原因;请求挂起而非报错时查锁等待视图。日志里根本找不到这条请求,说明它没到达服务端,方向应回到前端、网关或域名解析。
环境变量与部署差异:本地好、线上坏的头号原因
上线才出现的问题,很大一部分不是代码写错,而是运行环境不同:连接串为空时有些框架会静默回退到本地默认库,表现成「线上数据莫名其妙不对」;前端通常只注入带特定前缀的变量,私密密钥被放到前端前缀下既报错又泄露;功能开关、回调域名、第三方 key 在预发与正式环境不一致,导致本地复现不了。
处理顺序固定为:先 diff 环境变量,再 diff 域名与代理,最后才 diff 代码。部署日志里出现「变量未定义」「无法解析主机」「连接被拒绝」,基本可直接锁定这一层。
curl 交叉验证:判断归属最快的一步

在 Network 右键请求选 Copy as cURL,到终端原样执行:
curl -X POST 'https://api.example.com/leads' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer $TOKEN' \
-d '{"account":"test","email":"[email protected]"}' \
-v --max-time 10
规则很干脆:curl 也失败,问题在后端接口、鉴权、网络或数据库;curl 成功而页面失败,问题在前端代码、浏览器环境、跨域或代理;两者都成功但页面仍不对,查渲染与字段映射;两者都失败而后端坚持本地没问题,先比对环境与版本。-v 打印 DNS 解析、TCP 连接、TLS 握手与请求头,--max-time 防止接口挂住把排查变成等待。
AI Agent 能不能看日志、定位并改代码
可以,前提是给它的材料像一份工单,而不是一句「报错了」。有效输入至少三样:报错原文(复制,不要转述)、相关代码或文件路径、你期望发生什么,少一样它只能靠猜。
更重要的是把分析和修改拆成两轮:第一轮只说原因、不动代码,方向确认后再改;第二轮划定边界,比如只改某个文件、不动数据库结构和其他页面,并要求它列出改了哪几处。同一个地方改三四轮还是老样子,说明定位方向本身错了,此时应停下来重新描述完整现象,而不是继续打补丁。
团队应该固化的三条流程
对没有专职后端的团队,风险不在于修不好,而在于每次都从头摸索。
第一,上线前在正式域名上走通每个表单、支付入口与登录流程,比在预览环境点十次更有价值。第二,用统一模板描述问题:环境、时间、账号、操作步骤、期望结果、实际结果、请求路径与状态码、响应体、已做验证、怀疑点。第三,把「上线后才暴露」的变量往前移,页面结构、表单字段与 API 路径尽量在生成阶段确定。
FAQ
Q1: 接口报错但 Console 里没有红字,是什么情况?
前端代码执行正常,问题通常在服务端或数据层。看 Network 的状态码与响应体,再拿 traceId 查服务端日志。
Q2: 页面提示成功但数据没进数据库,先查哪一边?
先查数据库,再查接口。手工执行同参数查询确认记录是否存在;不存在就回后端日志看写入是否真的发生,最后才怀疑前端只弹了成功提示。
Q3: 500 一定是后端的问题吗?
不一定。500 表示服务端抛出未捕获异常,诱因可能是前端传入的脏数据、缺失字段或非法类型;用同一请求体 curl 复现,并对照堆栈里触发异常的那一行。
Summary
AI 生成的网站出现接口报错,处理顺序是:用现象把问题分到前端、契约、后端、数据库或环境配置中的某一层;用 Console 判断请求有没有离开浏览器;用 Network 核对请求与响应;用状态码缩小到客户端还是服务端;用 curl 交叉验证归属;最后用带 traceId 的日志和手工数据库查询确认根因,改一处、验一处。报错因此从「需要重做」变成「需要修一处」。


