SDK 异常通常是 GlassError，包含 code、message 和 retryable。用 code 判断处理分支。message 可用于诊断，面向用户的提示应说明接下来能做什么。retryable 不能代替业务层判断原操作是否已执行。
| 错误码 | 处理方式 |
|---|---|
BRIDGE_UNAVAILABLE |
从眼镜 Host 打开应用，或在浏览器开发时明确启用 mock。 |
NOT_READY |
等待 glass.ready() 成功后调用。 |
DISPOSED、STALE_CONTEXT、CONTEXT_EXPIRED、APP_BACKGROUND |
回到有效前台页面，重新握手并读取必要状态。 |
UNSUPPORTED_CAPABILITY |
核对 Host、应用能力或逻辑服务配置。 |
PERMISSION_DENIED |
检查清单和应用授权。 |
CAMERA_PERMISSION_REQUIRED、MICROPHONE_PERMISSION_REQUIRED |
处理对应 Android 系统权限。 |
REVISION_CONFLICT |
保留编辑，读取新修订号后解决冲突。 |
STORAGE_FULL、LIMIT_EXCEEDED |
检查应用存储、媒体空间或调用预算，避免增加无效重试。 |
PHONE_DISCONNECTED、NETWORK_UNAVAILABLE |
核对配对、手机连接、联网路由和服务，恢复后先读状态。 |
FILE_NOT_FOUND、FILE_ACCESS_DENIED |
核对当前应用、会话、受管文件是否存在和保留。 |
USE_DURABLE_OPERATION |
按原意图使用持久写入入口。 |
IDEMPOTENCY_CONFLICT |
核对原键对应的请求内容，按原操作查询。 |
TIMEOUT、RESULT_UNKNOWN |
只读请求可在恢复后重试。原生副作用需先查询原操作。 |
CANCELLED |
核对是本地等待结束还是 Host 返回已取消。 |
普通 HTTP 非 2xx 响应可能直接返回 HttpResponse，应用要单独检查状态码和响应体。安装或签名失败见 排查接入问题。