500/502错误需按五步系统排查：一、验证api连通性并配置代理；二、清理dns、ide缓存及.lingma目录；三、切换mcp服务通信模式为stdio；四、手动启动lingma服务进程；五、调高ide堆内存至2048mb并确保架构匹配。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用Qoder CN时遇到500或502错误代码，表明请求已抵达服务器端但未能成功完成处理。500 Internal Server Error代表服务器内部发生未预期的故障；502 Bad Gateway则说明网关或代理服务从上游服务器收到了无效、不完整或超时的响应。以下是针对这两类错误的系统化定位与修复步骤：
一、验证本地网络与代理配置
该步骤用于排除客户端侧因网络中断、DNS解析失败或代理设置异常导致的500/502误报。Qoder CN依赖稳定访问特定API端点以完成初始化和模型调用，若基础连通性受损，将直接触发网关层错误。
1、执行命令：curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping，确认返回值为pong。
2、执行命令：curl -I https://devops.aliyun.com，确认HTTP状态码为302。
3、若任一命令失败，检查公司防火墙策略，将上述域名加入白名单；如不可行，则手动配置代理：编辑文件C:\Users\[用户名]\AppData\Local\.lingma\config.json，修改http_proxy字段为IT部门提供的有效代理地址。
4、清理本地DNS缓存：Windows系统运行ipconfig /flushdns，macOS系统运行sudo killall -HUP mDNSResponder。
二、重置Qoder CN本地运行环境
该步骤用于消除因缓存污染、配置残留或进程锁死引发的500/502表现。Qoder CN启动过程中若加载了损坏的上下文或冲突的MCP服务实例，可能使服务端响应异常，进而被网关判定为无效响应。
1、以管理员权限启动IDE，打开一个非空项目文件夹。
2、点击右下角Qoder CN图标，选择高级设置 → 结束Qoder CN进程。
3、彻底删除本地数据目录：C:\Users\[用户名]\.lingma（Windows）或~/.lingma（macOS）。
4、依次点击IDE菜单File → Invalidate Caches and Restart → Invalidate and Restart。
5、重启后，进入个人设置 → MCP服务，确认已启用的MCP服务数量未超过10个上限，且无处于STDIO模式但未响应的本地服务进程。
三、强制切换MCP通信模式并禁用可疑服务
该步骤用于隔离因MCP服务协议兼容性问题或远端SSE连接中断所引发的502错误。部分MCP服务在SSE模式下若心跳超时或响应流截断，会导致Qoder CN向网关返回不完整payload，从而被判定为Bad Gateway。
1、进入个人设置 → MCP服务页面。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
2、对所有已启用的MCP服务，逐一点击右侧编辑按钮。
3、将通信模式由SSE更改为STDIO（仅适用于本地可执行服务）。
4、若某MCP服务无法切换或切换后仍报错，临时取消勾选该服务，并保存设置。
5、关闭当前IDE窗口，重新以管理员权限启动，观察是否仍出现500或502错误。
四、手动启动Qoder CN核心服务进程
该步骤用于绕过IDE插件自动拉起机制中的潜在缺陷，直接验证底层服务二进制是否可正常运行。当插件层因版本不匹配或内存不足而无法正确传递参数时，可能导致服务崩溃并返回500错误。
1、定位到本地bin目录：.lingma/bin/x.x.x/CPU架构_64_系统/（例如x86_64_windows）。
2、在该目录下打开终端，执行：Lingma.exe start（Windows）或./lingma start（macOS/Linux）。
3、等待终端输出Service started successfully及监听端口信息（如Listening on http://127.0.0.1:xxxx）。
4、返回IDE，点击登录按钮，确认错误是否消失。
五、检查IDE堆内存与系统架构兼容性
该步骤用于识别因资源不足或二进制不兼容导致的500错误。Qoder CN在处理大模型上下文或并发MCP调用时需充足堆内存；若IDE分配内存低于1536MB，或运行于ARM架构却加载x86_64二进制，均可能触发JVM异常或进程退出，造成网关接收空响应。
1、在JetBrains IDE中，依次点击Help → Change Memory Settings，将堆内存设为2048 MB或更高。
2、确认操作系统架构与Qoder CN插件版本匹配：x86_64系统须安装x86_64版本插件，Apple Silicon（ARM64）设备须安装ARM64版本插件。
3、若提示“不兼容的程序”，点击右下角Qoder CN图标→高级设置，修改解压路径至非C盘的空文件夹，重启IDE。
4、检查公司内网安全策略：部分企业级EDR软件会对.lingma/bin/下的可执行文件加锁，需联系IT部门临时放行或添加信任规则。
