异常处理
更新时间 2026-05-09 17:04:43
最近更新时间: 2026-05-09 17:04:43
本文介绍 AIuse 云电脑 SDK 和 MCP 接入中常见错误码、异常类型和处理建议。
通用返回结构
SDK 方法通常返回如下结构：
{
"code": 0,
"data": null,
"msg": null
}| 字段 | 说明 |
|---|---|
| code | 状态码，0 通常表示成功 |
| data | 成功时返回的业务数据 |
| msg | 失败时返回的错误信息 |
常见业务错误码
| 错误码 | 说明 | 建议处理方式 |
|---|---|---|
| 52060 | 指定桌面不属于当前用户 | 检查 AccessKey 与云电脑关联关系 |
| 92006 | 桌面不在线 | 确认云电脑状态，必要时启动或更换云电脑 |
| 92100 | 通过 sessionId 找不到 session | 检查会话是否已关闭或过期 |
| 92101 | 消息发送失败 | 检查网络、桌面状态和服务可用性 |
| 92102 | 请求内容长度超过限制 | 减少单次请求内容，文件内容建议分片读取或分批写入 |
| 92103 | 找不到请求记录 | 检查请求状态和会话状态 |
| 92104 | 功能未开放，请联系管理员 | 确认租户是否已开通对应能力 |
| 92105 | 功能未开放，请联系管理员 | 确认租户是否已开通对应能力 |
异常分类
| 类型 | 示例 | 处理建议 |
|---|---|---|
| 鉴权异常 | AccessKey 错误、Secret 错误 | 检查密钥配置和权限 |
| 资源异常 | 云电脑不在线、桌面不属于当前用户 | 检查资源状态和绑定关系 |
| 会话异常 | session 不存在、会话过期 | 重新创建会话 |
| 参数异常 | 坐标缺失、路径为空、消息过长 | 校验请求参数 |
| 执行异常 | 点击无响应、截图失败、文件读取失败 | 结合截图和日志排查 |
重试建议
可以有限重试的场景：
临时网络抖动。
截图短暂失败。
应用加载未完成。
文件尚未生成。
不建议盲目重试的场景：
删除文件。
覆盖写入文件。
点击提交、确认、支付等具有业务副作用的按钮。
已明确返回鉴权失败或权限不足。
排查信息
提交问题时建议提供以下信息：
调用时间。
租户信息或项目标识。
脱敏后的 AccessKey ID。
桌面编码。
sessionId。
接口名称和请求参数摘要。
错误码和错误信息。
必要的截图或日志。
请勿在工单、邮件或聊天工具中发送完整 AccessKey Secret。
