公众号 IP 白名单报错排查与固定出口方案

如果看到 ip xxx.xxx.xxx.xxx not in whitelist，被挡住的只有微信副作用调用。Convert API 不是微信副作用，永远不需要白名单——见 Auth。

哪些调用会查白名单

素材上传、草稿创建、图片消息走微信开放平台，平台会校验调用方 IP 是否在白名单内。渲染不查。

三步清除

curl ifconfig.me

1. 拿到运行 CLI 机器的出口 IP。
2. 在微信公众平台「开发接口管理 → IP 白名单」加入该 IP。
3. 等 1-5 分钟重试。

什么时候会反复出现

• 家庭/办公宽带的公网 IP 会轮换，今天的条目会过期。
• GitHub Actions 这类 CI 每次运行都用新的出口网段。

固定出口方案

wechat:
  proxy_url: http://user:pass@host:port

代理只作用于微信副作用（upload、draft add、图片消息），不影响 Convert API、图片供应商、discovery 与 preview。启用代理需要有效 MD2WECHAT_API_KEY，且 md2wechat config show 永远对密码打码。完整说明：微信 IP 白名单。

相关阅读

• 发布 API——草稿真正的去向
• 多账号发布——命名账号共享同一出口逻辑