Bmob Error Codes

Bmob 错误码字典

Bmob 的报错由三个独立编号空间组成：

1. Android SDK 本地错误：9001–9023（在 SDK 客户端侧抛出，不会走网络）
2. iOS SDK 本地错误：100、20000–20030（在 SDK 客户端侧抛出）
3. REST API 服务端错误：HTTP 状态码 + 业务码（401 / 500 / 400 + body 里的 code 字段，所有 SDK 的网络错误本质都是这个）

关键诊断流程：拿到错误后先看是不是网络错误（看响应体里有没有 { "code": ..., "error": "..." }），如果是，按 REST API 错误码表查；如果没有响应体只有 SDK 抛出的本地 code（9xxx 或 2xxxx），按 SDK 本地表查。

按现象反查（响应体 error 英文）

更多路由类问题：shared/faq.md。

1. Android SDK 本地错误码（9001–9023）

9015 专题

9015 是 Android SDK 的兜底错误码——所有未明确分类的异常都返回它。处理它必须看响应体的描述字段，不能只看 code。

特别警示：如果你在 Bmob SDK 的 success 回调里调用业务方法抛了异常，SDK 会把这个异常捕获并以 9015 形式触发 error 回调，造成"done 看似被调了两次"的错觉。修复方案是在业务方法里加 try/catch。

2. iOS SDK 本地错误码（100、20000–20030）

3. REST API 服务端错误码（任意端通过 HTTP 返回）

HTTP 401 / 500（无 body code）

{ "error": "unauthorized" }

HTTP 400（带 body code）— 核心错误码

{ "code": 101, "error": "object not found for e1kXT22L" }

对象 / 查询 / Class（100–199）

推送 / 设备（131–141）

时间 / 文件 / 图片（142–165）

用户系统（201–211）

支付（232–236、10001–10006）

云函数 / 钩子（310–324）

其他

短信（10010–10022）

应用管理（10030–10042）

Schema 管理（10061–10075）

QPS / 配额（10076、10210）

排查流程（推荐）

flowchart TD
    Start([拿到 Bmob 错误]) --> A{有 HTTP 响应体吗?}
    A -->|有 code + error| B[REST API 服务端错误码表]
    A -->|纯 SDK 本地抛出| C{Android or iOS?}
    C -->|Android| D[9001-9023 表]
    C -->|iOS| E[100, 20000-20030 表]
    B --> F[读 error 字段的描述]
    D --> F
    E --> F
    F --> G{描述里有变量 (%s, %d)?}
    G -->|有| H[把变量值代入定位具体字段/资源]
    G -->|没有| I[按表中"修复建议"操作]
    H --> I

完整原文

metadata.docs_raw 是 agent 可直接 WebFetch 的纯 markdown 版（原表里部分行带换行格式）：

https://raw.githubusercontent.com/bmob/BmobDocs/master/mds/other/error_code/index.md

需要在 IDE 内复核某个不在本 skill 表内的码（例如 Bmob 未来新增），直接 fetch 该 URL 即可。