502错误是网关收到上游服务器无效响应所致；普通用户应强制刷新、清缓存、换DNS，管理员需检查后端服务与代理配置。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
当你在使用 Fitten Code 时突然看到“502：网关超时”或“服务维护中”的提示，页面卡在加载状态、代码无法提交、AI补全中断——这不是你本地网络或浏览器的问题，而是请求在 Fitten Code 的网关层（如 Nginx、Cloudflare 或自研代理）与后端服务（如代码分析引擎、向量数据库、LLM 接口）之间断开了连接。
确认是否为全局服务异常
打开 https://status.fitten.dev（Fitten Code 官方状态页），查看「API Service」「AI Engine」「Auth Gateway」三项是否显示红色 ❌ 或黄色 ⚠️。若任一模块标注“Degraded”或“Outage”，说明问题出在服务端，无需继续排查本地环境。
这一步操作起来很简单，直接把链接粘贴进新标签页即可。如果状态页无法打开，再用手机切换蜂窝网络访问同一地址——【状态页本身不可用，是 502 故障最直接的佐证】。
快速跳过缓存干扰的三步验证
方法一：强制刷新并绕过 CDN 缓存
Windows 按 Ctrl + Shift + R，Mac 按 Cmd + Shift + R。该操作会丢弃当前页面所有缓存资源，重新向网关发起原始请求，避免因 CDN 缓存了上游错误响应而持续返回 502。
方法二：临时禁用浏览器扩展
点击右上角扩展图标 → 关闭所有非必要插件（尤其广告拦截、隐私保护、代理类扩展）。某些插件会篡改请求头或劫持 fetch 调用，导致网关拒绝转发。
方法三：用隐身窗口直连
按 Ctrl + Shift + N（Win）或 Cmd + Shift + N（Mac）新建无痕窗口 → 直接访问 Fitten Code 主站 → 尝试打开一个已有文件并触发补全。隐身模式不加载任何本地缓存、Cookie 和扩展脚本，能排除 90% 的前端侧干扰。
本地 DNS 与网络链路自检
第一步：刷新本地 DNS 缓存
在 Windows 上按 Win+R，输入 cmd 回车，执行：
ipconfig /flushdns
第二步：测试网关可达性
仍在命令行中，执行：
ping -n 4 api.fitten.dev
若出现“请求超时”或“找不到主机”，说明 DNS 解析失败或网络路径中断；若返回正常 IP 和延迟，则网关入口可通，问题在服务内部。
第三步：绕过本地 DNS 尝试直连
若 ping 失败，将浏览器地址栏改为 https://[IP地址]/editor（IP 地址需从其他已知正常设备上 nslookup api.fitten.dev 获取），跳过 DNS 查询环节。这能确认是否为 DNS 劫持或污染所致——【注意：仅限临时测试，切勿保存含 IP 的书签】。
开发者视角下的应急替代方案
方法1：切换至离线 CLI 工具链
运行 fitten-cli submit --file main.py --offline，利用本地缓存的模型权重与语法规则完成基础 lint 和补全，不依赖实时网关。
方法2：降级使用 WebAssembly 版内核
在 Fitten Code 设置中开启「WASM Fallback Mode」，启用编译到浏览器的轻量版分析引擎，牺牲部分大模型能力，换取稳定响应。
方法3：导出为 VS Code 插件工作区
点击右上角「Export to VS Code」→ 下载 .code-workspace 文件 → 在本地 VS Code 中打开 → 安装官方 Fitten 插件 → 启用「Local Inference Only」开关。所有代码处理均在本地进行，完全规避网关层。
