微信运营日常检查与故障排查

启用前检查

1. 重新登录后台并确认所需菜单和按钮可见。
2. 检查公众号、小程序和第三方平台账号类型与租户归属。
3. 在账号健康中心确认凭据有效。
4. 选择账号执行一次只读查询。
5. 执行一项可逆写操作，并再次查询微信最终状态。
6. 检查 API 日志、事件中心和告警是否正常记录。
7. 使用具备对应官方能力的真实账号完成关键流程抽查。

错误：微信应用类型不正确

原因通常是公众号与小程序账号混用。检查：

• 公众号必须 app_type=2。
• 小程序必须 app_type=1。
• 页面是否使用当前工作台专用 /accounts 或 /apps 接口。
• AppID 是否属于当前租户。
• 浏览器缓存是否仍保留上一次选择的账号。

不要取消服务端类型校验，否则错误 AppID 会被继续发送给微信接口。

错误：凭据无法解密或获取 token 失败

检查：

1. WX_CREDENTIAL_KEY_V1 是否存在。
2. Base64 解码后是否正好 32 字节。
3. 同一环境的所有实例是否使用相同密钥环。
4. primary-key-id 指向的密钥版本是否存在。
5. 数据库密文引用的密钥版本是否仍然保留。
6. 微信侧 AppSecret 是否被重置或账号是否受限。

密钥丢失无法从密文反推，必须从安全备份恢复或重新录入微信凭据。

错误：菜单没有出现或按钮返回 403

• 检查角色是否拥有父菜单和对应按钮权限。
• 检查所选账号是否属于当前租户。
• 平台域名、代码模板库等平台能力只对平台管理员开放。
• 退出后重新登录，刷新菜单和权限缓存。
• 通过接口权限索引核对页面功能所需权限。

错误：投诉列表为空或接口 404

投诉列表来自 complaint_callback 回调快照，不应调用 /cgi-bin/miniapp/complaint/list。

• 检查小程序消息回调公网地址。
• 检查 Token 和 EncodingAESKey。
• 检查事件中心是否收到投诉回调。
• 检查投诉回调是否处理成功。
• 历史投诉可使用投诉单号手动同步。

错误：备案订单接口失败

• 检查小程序是否具备备案能力和所需授权集。
• 检查是否已经初始化备案流程。
• 检查主体、负责人、小程序基本信息和材料是否完整。
• 检查当前备案状态是否允许提交、撤回或取消。
• 根据微信错误码确认材料格式、大小和服务类目。

备案材料不会在本地长期保存，失败后应根据微信提示修正当前阶段数据。

插件 AppID 或版本没有可选项

• 先刷新微信实时插件列表。
• 只有微信返回的插件或支持快速更新的版本才能直接选择。
• 新申请插件仍可能需要从微信公众平台取得 AppID。
• 插件申请需要插件提供方确认，申请中状态不能作为已可用状态。
• 小程序代码包仍需声明对应插件。

直播成员查询或新增失败

• 小程序必须已经开通直播能力。
• 微信号必须准确且不含首尾空格。
• 只能新增管理员、主播和运营者，超级管理员只读。
• 微信接口每页最多返回 30 条。
• 同一微信号解除一个角色不会删除其他角色。

微信接口无权限

依次检查：

1. 账号主体和认证状态。
2. 公众号或小程序账号类型。
3. 第三方平台授权集是否包含该能力。
4. 官方能力是否已经申请并通过。
5. 调用账号是否处于封禁、审核或限制状态。

后台角色权限不能绕过微信官方的账号能力和授权范围。

常见响应判断

定期功能抽查

• 公众号模板消息：同步模板 → 试发 → 创建任务 → 查看明细。
• 公众号订阅通知：添加模板 → 用户订阅 → 发送 → 查看回执。
• 公众号客服：查询账号 → 创建会话 → 查记录 → 输入状态 → 关闭会话。
• 小程序发布：上传 → 体验 → 提审 → 刷新审核状态。
• 小程序安全：提交测试内容 → 刷新检测结果。
• 投诉：回调到达 → 列表 → 详情 → 回复或完成处理。
• 物流助手：查询快递公司 → 绑定测试账号 → 查询余额或打印员。
• 第三方平台：模板列表 → 授权账号同步 → 对账 → 域名查询。
• 直播成员：查询 → 添加测试角色 → 解除测试角色。

高风险操作

正式发布、版本回退、平台域名修改、Open Platform 解绑、成员删除和凭据轮换会直接影响微信侧状态。执行前应确认账号、影响范围和反向操作方式，并保留操作日志。