使用控制台快速开始
常见接入失败排查
快速开始: 常见接入失败排查
控制台找不到事件
按以下顺序检查：
- 是否选择了正确的组织。
- 是否选择了正确的应用和 Region。
- 时间范围是否包含请求发生时间，并注意 UTC+0 与本地时间差异。
- SDK 是否返回了 Request ID。
- Public API Key 是否来自当前接入端。
- 接入端和应用是否处于启用状态。
- 请求是否因来源校验、签名校验、限流或配额不足被拒绝。
- 事件入库或控制台展示是否存在短暂延迟。
Public API Key 无效
可能原因：
- 复制了其他接入端或其他平台的 Key。
- Key 所属接入端已停用或删除。
- 所属应用已停用或删除。
- 客户端配置中存在多余空格或使用了旧构建配置。
处理建议：重新从接入端详情复制完整 Key，核对应用、平台和环境后重新构建。
Web 来源校验失败
检查：
- Origin 是否包含正确的
http://或https://。 - 域名、子域名和端口是否完全匹配。
- Allowed Origins 中是否误填了页面路径。
- Referer 通配符和路径规则是否正确。
- 测试环境是否使用了未加入允许列表的域名。
iOS 校验失败
检查：
- Bundle ID 是否与实际构建一致。
- 测试版和正式版是否使用了不同 Bundle ID。
- 是否错误地将 Android 接入端的 Key 用于 iOS。
- 应用签名校验开启后是否缺少必要配置。
Android 校验失败
检查：
- Package Name 是否完全一致。
- Debug 和 Release 是否使用不同签名。
- App Signature 是否复制完整且格式正确。
- 是否错误地将其他平台的 Key 用于 Android。
请求被限流
如果短时间内重复测试，可能触发每分钟或每小时限制。检查接入端限流、应用级限制和组织套餐配额。
进入下一时间窗口后，接入端限流通常会自然恢复。不要为了通过测试直接取消所有保护，应根据实际业务峰值调整阈值。
配额或订阅状态异常
组织欠费、订阅停用或配额耗尽时，组织级状态可能优先阻断请求，即使应用和接入端仍显示为启用。
请联系组织主账号检查订阅和配额状态。
仍然无法完成验证
联系技术支持前，请准备以下信息：
- 组织名称和应用名称。
- Region 和接入端平台。
- 经过脱敏的 Public API Key 前后缀。
- 测试时间及所用时区。
- Request ID（如果已经生成）。
- SDK 名称、版本和初始化方式。
- 完整错误码与错误信息。
- 可以复现问题的最小步骤。
不要通过邮件、工单或即时通讯发送完整服务端密钥、Webhook Token 或其他敏感凭据。
图示：首个事件故障排查