报障前先按下面清单过一遍，能省不少来回。 准备这些材料：Bot ID（xxx@im.bot）、目标用户 ID、是否群聊、最后正常发送时间、开始异常时间。日志里重点截 ret、errcode、errmsg、context_token 这几项，还有 /ilink/bot/sendmessage 的入参。 优先排查： ret=-2 / 缺 context_token：用户超过 8 小时没互动，token 失效，让对方先发一条再重试。 errcode=-14：登录态过期，重新扫码。 无报错但不投：gateway 长轮询断链或进程僵死，ps aux 查一下，不行就重启。 群聊不投：iLink Bot 一般不支持普通群聊，改用 1v1。 多实例冲突：同一 token 被多个 gateway 占着，停掉多余的。 定时推送失效：24 小时窗口内用户没发消息，加个健康检查消息刷新 token。 提报话术： Bot ID：xxx@im.bot，目标：xxx@im.wechat，1v1/群聊：，最后正常时间：，异常开始：。sendmessage 返回 ret=，errmsg=__，context_token 已/未携带。日志见附件，已确认 gateway 存活/已重启，对方已于 __ 发过消息仍不投递。 把 ret、token 是否有效、是否群聊、是否超 24 小时无用户消息写清楚，基本就能定位。 官方详细解决方案：https://cloud.tencent.com/solution/wechat... 展开详请