公众号草稿箱推送失败：常见原因与排查顺序

草稿箱推送失败，十次里有九次不是排版工具的问题，而是公众号侧的接口配置。工具只是调用微信接口的一方，权限、白名单、凭据任何一项不对，请求都会被微信直接拒绝。

先把错误信息里的 `errcode` 找出来。有错误码，排查就有方向；只有一句「推送失败」，先去看工具的错误详情，通常会带上微信返回的原始信息。

一、先确认三个前提

1. 公众号类型是否具备接口权限

不是所有公众号都能调接口。个人订阅号没有开发接口权限，无法通过第三方工具推送草稿。认证的服务号和部分认证订阅号才具备相应能力。如果绑定的是个人订阅号，任何工具都推不了，这是第一件要确认的事。

2. 服务器 IP 是否在白名单

微信要求调用接口的服务器 IP 在公众号后台的白名单里。工具的服务端 IP 变了、你换了网络出口、或者从来没配过白名单，都会报 IP 相关错误。

3. AppID 和 AppSecret 是否正确

这两个值在公众号后台「开发 → 基本配置」里。AppSecret 只显示一次，重置后旧值立即失效。如果最近重置过密码或密钥，需要在工具里重新绑定。

二、按错误码定位

下面是草稿箱推送最常见的几个错误码，按出现频率排序：

错误码只是入口，真正的修复动作通常在公众号后台，而不是在排版工具里。

三、推荐排查顺序

1. 看错误码，确认是权限、IP、凭据还是频率问题。
2. 如果是 40164，去公众号后台「开发 → 基本配置 → IP 白名单」添加工具给出的出口 IP。
3. 如果是 40001 或 40013，重新核对 AppID 和 AppSecret，注意不要带空格和换行。
4. 如果是 48001，确认公众号类型和认证状态，个人订阅号没有接口权限。
5. 如果是 45009，当天不要再重试，等额度重置。
6. 如果是 40007，检查正文图片是否过大或格式不支持，换一张图重试。

改完配置后不要立刻连续重试。微信的 token 有缓存，连续失败可能触发频率限制，等一两分钟再推。

四、推送成功但草稿箱里没有

这种情况通常不是失败，而是看错了位置：

• 草稿在「草稿箱」，不在「发表记录」或「已群发」里。
• 确认登录的是同一个公众号，多账号时很容易切错。
• 草稿是按账号隔离的，团队成员推的草稿在同一个公众号下能看到，但不同公众号看不到。
• 部分工具需要手动点「同步」才会刷新列表，先刷新页面再看。

五、四个常见误区

• 以为推送等于群发。推送只是把内容放进草稿箱，群发仍然要在公众平台手动确认，这是微信的规则，不是工具的限制。
• 以为订阅号都能推。只有具备接口权限的公众号才可以，个人订阅号不行。
• 改了密码不更新配置。AppSecret 重置后旧值立即失效，必须在工具里重新绑定。
• 用错公众号的 AppID。同时运营多个公众号时，把 A 的密钥填到 B 的绑定里，会报 40013 或 40001。

六、仍然推不出去怎么办

按上面的顺序走完还是失败，把三样东西准备好再找支持：错误码和完整错误信息、公众号类型与认证状态、出错的时间点。有这三样，定位通常只需要几分钟。

如果暂时不想折腾接口，也可以先用「导出 HTML」或「复制微信格式」，手动粘贴到公众号后台。排版效果不会丢，只是多一步操作。