connection refused或连接超时问题源于qoder服务未运行、api域名被拦截、代理未配置、端口被占用或缓存损坏；需依次检查lingma进程、测试lingma-api与devops域名连通性、配置http_proxy、释放占用端口、清除.lingma目录及ide缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder大模型功能时频繁遇到Connection Refused或连接超时问题，这通常意味着客户端无法成功建立与后端AI服务的网络通道。以下是针对该问题的多种独立排查与修复路径：
一、验证Qoder服务进程是否正常运行
Qoder CN依赖本地后台服务进程（Lingma.exe）提供模型调用能力，若该进程未启动或意外退出，所有请求均会返回Connection Refused错误。
1、打开任务管理器（Windows）或活动监视器（macOS），搜索进程名“Lingma”或“qoder”。
2、若未发现该进程，进入目录：C:\Users\[用户名]\AppData\Local\.lingma\bin\x.x.x\CPU架构_64_系统\（Windows）或~/.lingma/bin/x.x.x/CPU架构_64_系统/（macOS）。
3、双击执行Lingma.exe start（Windows）或终端中运行./Lingma start（macOS）。
4、等待命令行输出"Service started on http://127.0.0.1:xxxx"，确认端口监听已就绪。
二、检查API端点连通性与白名单状态
Qoder CN默认需访问两个核心域名：lingma-api.tongyi.aliyun.com（模型调度）和devops.aliyun.com（鉴权与元数据）。任一地址被拦截将导致连接拒绝或超时。
1、在命令行中执行：curl -I https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping，预期返回HTTP 200及响应体“pong”。
2、执行：curl -I https://devops.aliyun.com，预期返回HTTP 302重定向状态码。
3、若任一命令卡顿超过10秒或报错“Failed to connect”，说明网络策略阻断，需联系IT部门将上述域名加入企业防火墙白名单。
三、手动配置代理绕过内网限制
当白名单不可行时，可通过显式代理配置将流量导向合规出口，避免直连失败引发的Connection Refused。
1、获取公司IT提供的代理地址，格式必须为：http://user:pass@proxy.company.com:8080或https://user:pass@proxy.company.com:8080。
2、编辑配置文件：C:\Users\[用户名]\AppData\Local\.lingma\config.json（Windows）或~/.lingma/config.json（macOS）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、在JSON根对象中添加字段："http_proxy": "http://user:pass@proxy.company.com:8080"，确保引号闭合且无语法错误。
4、保存文件后，彻底结束Lingma进程并重启IDE，使新配置生效。
四、释放被占用的本地服务端口
Qoder CN服务默认监听动态端口（如50051、8001等），若该端口被其他程序（如Docker、旧版IDE插件、测试服务）占用，会导致启动失败并触发后续所有连接拒绝。
1、在命令行中执行：netstat -ano | findstr :50051（Windows）或lsof -i :50051（macOS/Linux），替换50051为实际报错端口号。
2、记录输出中的PID（进程标识符）。
3、执行：taskkill /PID [PID] /F（Windows）或kill -9 [PID]（macOS/Linux）强制终止占用进程。
4、重新启动Qoder CN服务，观察日志是否出现端口绑定成功提示。
五、清除本地缓存与残留配置
损坏的缓存文件或过期的认证令牌可能干扰服务初始化流程，导致后台进程无法完成健康检查而提前退出，表现为间歇性Connection Refused或超时。
1、关闭IDE及所有Qoder相关进程。
2、删除本地配置目录：C:\Users\[用户名]\AppData\Local\.lingma（Windows）或~/.lingma（macOS）。
3、清理IDE缓存：在JetBrains系列IDE中依次点击File → Invalidate Caches and Restart → Invalidate and Restart。
4、以管理员权限（Windows）或sudo（macOS）重新启动IDE，并打开一个非空项目文件夹触发Qoder自动初始化。
