参考
错误与排障
对接时最常见的状态码与处理方式。
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。
