阶跃AI出现502错误时，首要确认是否为服务端全局故障：访问https://status.jieyue.ai查看Core Engine、Meeting Assistant、Doc AI状态，任一模块红❌或黄⚠️即表明上游服务宕机或降级，此时应等待官方修复，无需本地排查。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在使用阶跃AI智能办公时突然弹出“502 Bad Gateway”提示，文档无法保存、会议纪要生成中断、AI助手无响应——这不是你电脑卡顿或网线松了，而是请求在阶跃AI的网关层（如Nginx或自研API网关）与后端服务（如语义解析引擎、知识图谱服务、OCR识别模块）之间断开连接，上游服务未返回有效HTTP响应。
确认是否为阶跃AI全局服务异常
打开官方状态页 https://status.jieyue.ai → 新建标签页直接访问 → 查看「Core Engine」「Meeting Assistant」「Doc AI」三项状态图标。若任一模块显示红色 ❌ 或黄色 ⚠️，说明服务端已宕机或降级，本地所有操作都将失败。【状态页本身打不开，是502故障最直接的佐证】。此时无需继续排查本机，等待官方修复即可。
快速跳过缓存干扰的三步验证
方法一：强制刷新并绕过CDN缓存
Windows 按 Ctrl + Shift + R，Mac 按 Cmd + Shift + R。该操作丢弃当前页面全部缓存资源，重新向网关发起原始请求，避免因CDN缓存了上游错误响应而持续返回502。
方法二：临时禁用浏览器扩展
点击右上角扩展图标 → 关闭广告拦截、隐私保护、脚本注入类插件。某些插件会篡改fetch请求头或劫持XHR调用，导致网关拒绝转发请求，触发502。
方法三：用隐身窗口直连
按 Ctrl + Shift + N（Win）或 Cmd + Shift + N（Mac）新建无痕窗口 → 直接访问 https://ai.jieyue.com → 尝试上传一份PDF并触发“提取会议要点”。隐身模式不加载任何本地Cookie、缓存和扩展脚本，能排除90%前端侧干扰。
本地DNS与网络链路自检
第一步：刷新本地DNS缓存
Windows 上按 Win+R，输入 cmd 回车，执行：ipconfig /flushdns。
第二步：测试网关可达性
仍在命令行中，执行：ping -n 4 api.jieyue.ai。若返回“请求超时”或“找不到主机”，说明DNS解析失败或网络路径中断；若返回正常IP和延迟（如 Reply from 112.6.18.34: bytes=32 time=42ms TTL=52），则网关入口可通，问题在服务内部。
第三步：绕过本地DNS尝试直连
若 ping 失败，需从另一台已知正常联网的设备上执行 nslookup api.jieyue.ai 获取真实IP → 将浏览器地址栏改为 https://[获取到的IP]/dashboard → 回车访问。这能确认是否为本地DNS劫持或污染所致 —— 【仅限临时测试，切勿保存含IP的书签或配置】。
检查代理与防火墙设置
如果你所在单位强制使用代理上网：打开阶跃AI网页 → 右键空白处 → “检查” → 切换到 Console 标签页 → 输入 fetch("https://api.jieyue.ai/v1/health").then(r => r.text()).then(console.log) 回车。若返回 TypeError: Failed to fetch 或 net::ERR_PROXY_CONNECTION_FAILED，说明代理配置失效或IT策略变更，需联系内网管理员更新白名单域名 api.jieyue.ai 和 ai.jieyue.com。
家庭网络用户请检查路由器后台：登录 192.168.1.1 → 进入“防火墙”或“家长控制”页面 → 确认未启用“HTTPS过滤”或“深度包检测（DPI）”功能。这类功能会中间人解密HTTPS流量，导致阶跃AI的TLS握手失败，网关判定为无效请求而返回502。
