连接超时 / 网络失败

如果你遇到 timeout、Connection error、请求卡住或偶发网络失败，优先从网络层排查，而不是立即改业务逻辑。

常见原因

1. 本地网络或代理环境不稳定

尤其是桌面客户端、IDE 插件或本机代理软件，会直接影响请求能否送达。

2. 服务器出站网络差异

本地能调通，不代表服务器容器、云主机或生产环境也能调通。

3. 上游模型服务暂时波动

平台侧、上游侧都可能出现暂时性抖动，这类问题通常适合做重试，而不是做永久性大改。

推荐排查顺序

先用 curl 发最小请求
再看同样请求在本地和服务器上是否一致
再判断是不是代理、出站网络或 DNS 问题
最后再看业务程序的超时和重试策略

建议的程序策略

对 timeout 和 5xx 做有限次数重试
不要无限重试
记录失败请求的时间、状态码和错误消息

判断方法

本地和服务器都失败：优先看平台或上游状态
只有某个环境失败：优先看该环境网络
重试后成功：更像瞬时网络抖动