❌ API错误：upstream error: do request failed (request id: 202607260058055886745118595621) (request id: 202607260058055886745118595621)
当接口返回“upstream error: do request failed”时，通常说明请求已到达网关或中间层，但在转发到上游服务时出现失败，常见原因包括网络超时、服务不可用、负载过高、DNS 解析异常、证书或鉴权配置错误等。排查这类 API 错误，重点应结合 request id 查询日志，定位具体失败链路，并检查请求参数、网关配置、重试机制与上游服务状态是否正常。本文将围绕错误含义、常见触发场景、排查步骤和处理思路进行说明，帮助开发者更快判断问题来源，提升接口调用稳定性。