微信公众号图文群发故障排查经验

调接口返回 errcode 0，后台却显示「发表失败」。先别怀疑网络，多半是两个概念混在了一起。

一、提交成功 ≠ 发表成功

群发、发布接口的返回值只代表任务已受理，给的是 msg_id 或 publish_id。真正的结果在异步链路：群发看 MASSSENDJOBFINISH 事件的 Status，发布看 freepublish/get 的 publish_status。只判断 errcode，等于没做结果确认。

二、四类高频原因

权限。未认证服务号无群发与发布权限；第三方平台需用 authorizer_access_token，授权集缺权限或误用自家 token，提交后都会被拒。

额度。订阅号一天只有一次群发机会，失败后立刻重试只会撞掉额度；发布接口也有次数上限，重试救不回来。

内容。声明原创却没通过校验、转载未进白名单，会归为原创失败；正文外链图片、诱导分享、敏感词会被审核拦下，提交时不会告知。

对象。is_to_all 与 tag_id 混用、标签下没有粉丝、用户列表为空，任务照样能提交，发送时才发现无人可发。

三、排查顺序

1. 用 msg_id / publish_id 查最终状态，别只看返回值；
2. 核对 token 来源与授权权限集；
3. 检查当日额度，失败别立刻重发；
4. 看后台失败详情，区分原创失败、审核不通过、发送失败；
5. 同一草稿在后台手动发一次，能发出去说明问题在接口参数。

群发失败很少是接口挂了，多半是把异步结果当成了同步结果。