502 Upstream request failed 排查
排查 KunAI 返回的 status_code=502、Upstream request failed：通过新对话、最小请求、模型核对和上下文缩减定位临时服务、超时或长对话问题。
502 错误代表什么
status_code=502 或 Upstream request failed 表示本次请求没有及时获得可用的服务响应，但它不能单独证明某一个根因。临时服务异常、连接超时、模型不可用、请求过大或特定参数不兼容都可能产生相似表现。
逐步缩小问题范围
- 记录发生时间、接口路径、模型 ID、请求标识和已脱敏的错误信息，不要提交 API Key 或完整私密对话。
- 使用相同 API Key 和模型新建对话，只发送一条短文本且暂时移除附件、工具和结构化输出参数。
- 请求 GET https://kunai.one/v1/models，确认模型仍对当前账户可见，并核对模型 ID、Base URL 和实际端点。
- 如果最小请求成功，逐步恢复历史消息、流式输出、附件与工具；如果仍失败，稍后进行一次有间隔的验证并保留错误证据。
- 检查用量记录与请求状态后再重试；在结果不明确时不要连续、高并发地重复同一个请求。
长对话与自动压缩
当且仅当长对话失败而同一模型的新对话正常时，自动压缩或上下文整理才是可能的排查分支之一，不能仅凭 502 断言自动压缩失败。上下文上限、消息格式、附件大小、工具参数或等待超时也可能表现相似。
- 复制必要上下文到新对话并缩短历史消息，观察是否能稳定复现。
- 暂时移除大附件、超长工具结果和不必要的系统提示，逐项恢复以定位触发条件。
- 若问题持续，提供已脱敏的请求标识、时间、模型 ID、端点和最小复现步骤，便于进一步核对。