报错502“网关超时”表明qoder通过代理或网关请求后端服务时未及时获得响应，需依次执行：一、刷新页面或重启应用；二、检查并重置代理配置；三、清除本地缓存与会话数据；四、验证上游服务响应时效；五、调整网关超时参数至30秒。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder时遇到报错代码502，提示“网关超时”或与代理设置相关，则说明Qoder作为客户端，正通过代理或网关向后端服务发起请求，但未能在规定时间内收到有效响应。以下是解决此问题的步骤：
一、刷新页面并重试请求
该操作用于排除瞬时性服务过载或临时网络抖动导致的响应延迟。Qoder内部请求机制可能因上游服务短暂无响应而触发超时判定，强制重试可绕过缓存路径并重建连接。
1、在Qoder界面中点击右上角刷新按钮或按F5键。
2、等待5秒后观察是否仍显示502错误。
3、若失败，关闭Qoder主窗口后重新启动应用。
二、检查并重置Qoder代理配置
Qoder若启用了自定义HTTP/HTTPS代理，而该代理不可达、认证失败或转发策略异常，将导致网关层无法完成请求中转，直接返回502。需确认代理地址、端口、协议及认证凭据的准确性。
1、打开Qoder设置菜单，进入“网络”或“代理”选项页。
2、查看当前代理模式是否为“手动配置”，如是，记录下主机地址与端口号。
3、在终端执行命令测试代理连通性：curl -x http://[代理地址]:[端口] -I https://httpbin.org/get。
4、若返回超时或407错误，切换为“系统代理”或“不使用代理”并保存设置。
三、清除Qoder本地缓存与会话数据
本地缓存中可能残留过期的网关路由信息、失效的TLS会话票据或损坏的Cookie，干扰Qoder与代理 服务器之间的握手流程，造成响应解析失败。
1、关闭Qoder进程，确保后台无残留服务。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、定位Qoder缓存目录：Windows为%APPDATA%\Qoder\Cache，macOS为~/Library/Caches/Qoder，Linux为~/.cache/Qoder。
3、删除整个Cache文件夹及同级目录下的Session Storage和Cookies文件。
4、重启Qoder，触发全新会话初始化。
四、验证上游服务可达性与响应时效
Qoder所依赖的后端API或资源服务器若响应缓慢或返回非标准HTTP状态（如空响应、截断响应、非2xx/3xx状态码），Qoder内置网关模块将按超时策略中断连接并抛出502错误。
1、在命令行中执行：curl -v --connect-timeout 5 --max-time 15 https://api.qoder.example/v1/status（替换为实际API域名）。
2、观察输出中time_namelookup、time_connect、time_starttransfer三项耗时是否均低于5秒。
3、若time_starttransfer大于10秒，说明上游服务处理延迟已超出Qoder默认网关超时阈值。
五、调整Qoder网关超时参数
Qoder默认网关超时值通常设为8–10秒，适用于常规API响应；当后端涉及大文件预处理、数据库聚合查询等长耗时操作时，该值易被触发。修改超时阈值可避免误判。
1、在Qoder安装目录下查找配置文件config.json或settings.yaml。
2、定位字段gateway_timeout_ms或proxy_request_timeout。
3、将其值由默认10000修改为30000（单位毫秒，即30秒）。
4、保存文件后完全退出Qoder，再重新启动以使配置生效。
