---
title: "Bridge 错误码"
description: "根据错误码区分环境、权限、上下文、数据和原生操作问题。"
---

> Documentation Index
> Fetch the complete documentation index at: https://h5-app-docs.glass.tengyusmart.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Bridge 错误码

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`，应用要单独检查状态码和响应体。安装或签名失败见 [排查接入问题](https://h5-app-docs.glass.tengyusmart.cn/guide/troubleshooting/)。

Source: https://h5-app-docs.glass.tengyusmart.cn/reference/errors/index.mdx