Bmob 错误码手册

调试 Bmob 报错时，最常见的痛点是不知道错误该归到客户端还是服务端——尤其 9015 这种兜底码。这个技能把错误按三个独立编号空间拆开，并提供一套可复现的定位流程。

核心能力

• 三套错误码字典：Android SDK 本地码（9001–9023）、iOS SDK 本地码（100、20000–20030）、REST API 服务端码（HTTP 状态码 + body 中 code 字段）。
• 分层诊断逻辑：拿到错误先看响应体是否包含 { "code": ..., "error": "..." }，有则按 REST API 表查；只有本地 code 则按对应 SDK 表查。
• 高频场景直给：初始化失败、批量超 50 条、单文件超 10M、对象不存在、username 已被使用、QPS 超限、短信模板不存在等，均附修复建议。
• 兜底码专题：9015 会解释为何 success 回调里抛出的异常会被 SDK 捕获并以 error 回调形式返回，以及为何业务侧要加 try/catch。

使用方法

1. 用响应体结构判断是否走网络：有 code 字段进 REST API 区间，否则看 9xxx 或 2xxxx。
2. 在对应表中按码值定位含义，结合“常见原因 / 修复”列排查，例如 9001 对应 Bmob.initialize 未调用或时机不对，105 对应字段名撞上 objectId、createdAt 等保留字段。
3. 若表内查不到，可 fetch 原始 markdown 复核新增码。

适用边界

• 只做错误码查询与定位，不覆盖 SDK 初始化配置、ACL 策略设计、支付或短信模板的具体开通流程。
• 9015 是兜底码，不能只看 code，必须读 error 文本。
• iOS 表中 20000–20030 多对应参数缺失或格式错误，服务端深度异常仍需回到 REST API 区间。

适合后端、客户端工程师在写 try/catch 和排查线上日志时快速回查。