Vercel AI SDK 代理请求怎么调试：流式响应、超时与错误日志

Vercel AI SDK 请求可能在浏览器、应用、模型服务或反向代理之间中断。先用请求 ID定位链路，再区分流式缓冲、空闲超时和上游错误。

如何定位请求中断在哪一段

对齐浏览器、应用和模型服务日志中的请求 ID，记录状态码、开始时间、首字节时间、最后一个 chunk 时间和连接关闭方。4xx/5xx 先查认证、配额和上游响应，不要直接归因代理 IP。

可先用代理 IP 故障排查中心区分应用、代理和上游服务故障。

没有首个 chunk 或响应中途断开怎么办

用短响应和长响应做同条件对照，确认 SDK 是否启用流式输出、中间层是否缓冲，以及空闲超时是否短于响应间隔。没有首个 chunk 时查请求是否到达模型服务；固定时间断开时对照两端日志和最后数据帧。

流式连接涉及缓冲和超时时，可参考代理 IP 并发、QPS 和连接池怎么规划。

客户端超时不代表服务端未完成生成。先查任务状态，避免重复提交或重复计费；日志中不要保存凭据或完整敏感请求体。

下面按状态码、首个 chunk 和断开时间选择下一步。

若服务端已有结果，先查询状态，避免重复生成和重复计费。

如何用请求 ID 对照流式响应日志

将浏览器、应用、模型服务和反向代理日志按请求 ID对齐，记录状态码、首字节时间、chunk 间隔、最后一个 chunk、关闭时间和关闭方。短响应成功而长响应中断时，重点查缓冲和空闲超时；4xx/5xx 先查凭据、配额和上游响应。

客户端超时后怎样判断是否重试

先查询服务端任务状态，再决定是否重试；服务端已完成或仍在运行时不要重复提交，以免重复生成或计费。无首个 chunk 时查请求是否到达模型服务；固定时间断开时比较中间层和上游的最后数据帧。

重试前的状态确认可结合代理 API 错误码和程序报错怎么查。

用短响应和长响应区分流式故障

固定短响应和长响应各测一次，记录请求 ID、HTTP 状态、首字节时间、chunk 间隔、最后一字节时间和关闭原因。短响应 200 且 1.2 秒完成、长响应首字节 1.5 秒后每 2 秒一个 chunk，说明代理链路可用；若服务端状态仍 processing 而客户端超时，不要直接重复生成，先查询同一请求状态。

FAQ

没有收到首个 chunk 怎么定位？

先确认请求是否到达模型服务，再检查 SDK 流式配置和中间层缓冲。

短响应成功但长响应中断说明什么？

优先检查流式响应是否被中间层缓冲、空闲超时是否过短，以及长连接是否被上游关闭。

固定时间断开时先查哪里？

对照最后一个 chunk 的时间、反向代理超时和上游日志，判断断开发生在哪一段。

客户端超时后可以立即重新提交吗？

不应立即提交。先按请求 ID 查询服务端任务状态，避免任务仍在运行时重复生成或产生重复费用。