阶跃AI服务返回502错误说明网关层未能从后端获取有效响应，用户应先访问https://status.jumpai.com确认API与控制台状态，若标红则属服务端问题；再用curl验证真实响应，避免缓存干扰；普通用户需关闭页面、订阅故障推送、本地保存未提交内容；开发者须检查请求头、endpoint域名及并发限制。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
阶跃AI服务返回502错误时，说明其网关层未能从后端服务获取有效响应，此时用户无法继续调用模型或访问控制台，需立即判断是瞬时故障还是持续性问题，避免盲目重试浪费时间或错过关键操作窗口。
先确认是否真为服务端问题
打开 https://status.jumpai.com（阶跃AI官方状态页），查看“API服务”与“控制台”两项是否显示绿色正常标识。若任一栏标红或显示“Degraded”，说明故障已公开确认，无需进一步排查本地环境。
在另一台设备或网络（如手机切到4G）访问同一接口，若仍报502，则基本排除本机DNS、代理或防火墙干扰。
【务必跳过浏览器缓存重试】直接使用 curl 或 Postman 发起原始请求：curl -v "https://api.jumpai.com/v1/chat/completions" -H "Authorization: Bearer YOUR_TOKEN"，观察响应头中是否含 server: jumpai-gateway 字样及确切的 502 状态码——这能避开浏览器自动重定向或缓存伪造的成功假象。
普通用户等待期间可做的三件事
① 关闭所有正在运行的阶跃AI相关页面与插件，防止后台持续轮询加重网关压力。
② 订阅阶跃AI微信公众号 → 进入菜单栏「服务状态」→ 开启「故障推送提醒」，后续恢复会第一时间收到通知，不用反复刷页面。
③ 将当前未保存的提示词、对话历史复制粘贴至本地文本文件，502期间任何未提交的输入都可能丢失，【切勿依赖网页自动保存】。
开发者自查清单（仅限自有集成场景）
方法一：检查请求头是否合规
确保 Authorization 头格式为 Bearer
方法二：验证 endpoint 是否正确
中国大陆区必须使用 https://api.jumpai.com，境外用户需改用 https://api-intl.jumpai.com；错用域名会导致 DNS 解析失败后网关超时，触发 502 而非 DNS 错误。
方法三：限制并发请求数
单个 API Key 默认并发上限为 5，若代码中未加 semaphore 或 retry 指数退避，瞬间发出 20 个请求会直接压垮网关连接池，所有请求均收 502；此时需立即暂停调用，等待 60 秒后再以 ≤3 QPS 重启。
