浏览文档目录

参考

错误与排障

对接时最常见的状态码与处理方式。

  • 401:Token 不是 sbot_、已吊销、未审核通过或机器人 disabled。
  • 409:Webhook 仍开启时调用了 getUpdates → 先 deleteWebhook。
  • 429:配额;看 Retry-After、X-BotRateLimit-Remaining、X-BotRateLimit-Bot-Remaining。
  • 503:机器人初始化尚未完成,请稍后重试;持续出现时联系平台支持。
  • Webhook 验签失败:未使用原始 body,或未按 V2(timestamp + "." + rawBody)计算;头名是 X-StarIM-Signature-V2 / X-StarIM-Timestamp。
  • 群里收不到消息:检查群隐私模式与是否 @/命令触发。

控制台「投递日志」可看失败原因并重试 dead_letter。