错误诊断

留下可定位的信息

反馈应用 ID、版本、操作时间、调用接口、HTTP 状态、响应错误码和 X-Request-ID。网关可能替换客户端自带的请求 ID，以实际响应为准。

不要提交 Authorization、平台 token、业务登录态、登录码、手机号 code、短信验证码或完整用户资料。当前没有开发者自助日志查询页面，请将脱敏信息交给有权限的支持人员。

按失败阶段排查

现象	检查顺序
401	凭据种类、有效期、所属应用；会话接口再检查实例和吊销状态
403	当前身份权限、体验资格、原生用户同意及版本能力声明
404	应用/版本是否可见、code 是否有效；确认没有调用已删除的固定登录转发路由
409	版本/revision 或授权设置并发冲突；重新读取状态后由操作者确认
429	按 Retry-After 等待并限制重试频率
503 / 504	依赖配置、服务不可用或超时；提交请求 ID，不盲目重放一次性操作

HTTP 状态与业务错误码应一起使用，具体响应以对应 API 参考为准。参数错误修正请求后再试；过期或已消费的 code 必须重新取得。

发布与包加载

分发成功只说明取得了候选包，宿主还必须完成摘要、签名和包格式验证。校验失败不能关闭验签绕过。记录宿主版本、SDK 版本和制品摘要，区分下载失败、验签失败与实际运行失败。