常见问题与故障对照

一句话

大多数「出问题了」其实有固定形态：先看症状对照表定位原因，再照「先做什么」走一遍，通常不用重写稿子。

在哪打开

先确认你在哪一步出的问题：发布相关的都从编辑器右上角「发布」→「选择发布渠道」开始；账号相关的在侧栏「管理」→「媒体账号」；素材相关的在「管理」→「资源管理」；更新相关的在「设置」→「关于」。出问题时按「反馈问题或建议」把现象报回来最快。

主要动作

• 先看症状表：下面的对照表把「症状 → 可能原因 → 先做什么」列全了，从上往下对号入座。
• 收集证据：稿件里会记录每个平台的发布结果与错误原文（post_data 的 status / error / warning），这是判断「真失败」还是「草稿待发表」的唯一依据。
• 按平台重发：确认原因并处理后，用「重发失败平台」只补发失败平台。
• 检查更新：「设置」→「关于」→「检查更新」，macOS 上发现新版本会给「前往官网下载」而不是自动装。

字段 / 状态说明（症状 → 可能原因 → 先做什么）

症状	可能原因	先做什么
发布长时间没反应、一直停在「发布中…」	客户端或网络侧请求被挂起；单平台发布有 10 分钟兜底超时	等超时出结果，不要反复点发布；同一稿件在途会被锁住并提示「该稿件正在发布中，请等待完成后再操作」
发布报错里带 Credentials not found, please re-authenticate	该平台账号的授权凭证缺失或过期（账号仍显示已连接）	到「媒体账号」对那个账号重新认证，再对已有稿件重发——不用重写稿
微信发布报错里出现 errcode=40164、invalid ip ... not in whitelist	当前公网出口 IP 不在公众号的 IP 白名单里	去公众号后台「设置与开发 → 基本配置 → IP 白名单」把当前公网 IP 加进去，再加已有稿件重发
微信提示「草稿已创建，请前往公众号后台手动发表」	自动发表环节失败（如无该接口权限），草稿其实已经建好	去公众号后台草稿箱点发表；客户端记这次为成功，不用重发
发出去的正文里图片不显示	正文图上传失败：客户端会在成功结果上追加「有 N 张正文图片上传失败」的提示	看一下发布结果里的这条提示；确认图片仍在资源库、路径可读，再重发该平台
改了内容／换了图片，页面上还是旧的	CDN 边缘缓存还没过期：远程配置最长 12 小时全量生效，客户端也按 12 小时重新拉取	等缓存过期再确认，别急着当成没生效
数据找不到：明明有草稿/素材，登录后却看不到	这些内容只属于「本机」这份数据，还没归入当前账号	在「本机还有未归入的数据」弹窗里点「归入当前账号」；选「暂不归入」它会继续留在本机
更新被系统拦下、装不上	macOS 版未做 Apple 公证，自动更新装不上	按提示走「前往官网下载」手动装；macOS 上不会自动下载安装

与其它功能的关系

「发布结果」弹窗与「已发布」列表读的是同一份平台发布记录，两边状态一致。账号页决定能不能发、素材页决定图能不能读到，排发布问题时常要连着看。

限制与注意

• 封面请走内置生图能力（AI 生图或离线模板），不要自己装环境凑图；需要封面时在编辑器／发布弹窗里点「生成图片」即可。
• 失败记录不会覆盖同平台的历史成功记录，所以「重发失败平台」是安全的。
• 微信每次重新发布都会在公众号后台新建一份草稿，后台可能有多份，需要你手动清理。

常见问题

Q：发布报错原文去哪看？ A：稿件里按平台存着 status、error、warning。发布结果弹窗会直接展示失败原因，之后也能在「已发布」里看到「重发失败平台」。

Q：图片上传失败会不会把稿子发成裂图？ A：不会静默放过。部分失败会在成功结果上追加「有 N 张正文图片上传失败」的提示；如果一张都没上传成功，微信这条会直接判失败并说明原因，而不是发出裂图。

Q：换了电脑／退出登录后数据不见了？ A：先看有没有「本机还有未归入的数据」弹窗——那是未登录时创建的内容，归入当前账号后才能看到。

Q：为什么更新提示让我去官网下载？ A：macOS 产物未做 Apple 公证，自动更新下载能成功但装不上，所以客户端只提示新版本并引导去官网重装。

Q：发布到一半失败，重新发布会重复吗？ A：客户端按平台合并记录，不会重发已成功的平台；但微信侧重建的那份草稿会留在公众号后台，记得清理。