跳转到内容

运维手册

终端窗口
curl <api>/healthz
# => {"ok":true,"deps":{"db":"ok","redis":"ok","wikifx_content":"ok"}}

wikifx_content 为 not_configured 表示未配置 sidecar,不影响其它来源。

操作 步骤
开启真发 验证草稿链路后,把 DRY_RUN 改为 false
免审发布 AUTO_PUBLISH=true(WikiFX 与历史重生成内容仍强制审核)
  • 部署新版本时容器启动自动执行 prisma migrate deploy
  • 迁移文件在 apps/api/prisma/migrations/;迁移属兼容敏感操作,应用前需评估与批准
  • 旧库如用 db push 建表,需先 prisma migrate resolve --applied 0_init 标记基线
  • 发布任务、生成任务均由 BullMQ 承载;Redis 重启丢失的排队任务由补偿服务自动重入队
  • 结果未知的发布任务不会被自动重发,需在发布记录页人工对账
现象 排查方向
控制台 503/登录失败 api 健康检查、ADMIN_API_KEY 两侧是否一致
内容生成失败积压 LLM Key 配额、GENERATION_MODEL 是否可用
发布失败(Postiz 4xx/5xx) Postiz 服务状态、POSTIZ_API_KEY 是否过期
系统显示已发布但社媒没有 等待投递对账(每 30 分钟)或到发布记录页查看 failed 回退
WikiFX 正文为空 sidecar 健康、WIKIFX_CONTENT_API_KEY 两侧一致性

这些不是服务故障,而是平台侧配置或授权缺失。按下表定位,不必查日志:

运营的说法 真实原因 处理
「点绑定新账号报错」 该账号不在 Meta 应用授权名单,或邀请未接受 加进授权名单,让对方接受邀请
「生成授权链接失败」 POSTIZ_JWT_SECRET 未配置 补配该变量并重启 api
「帖子发了但同事刷不到 / 图片没了」 Meta 应用还在开发模式 切到 Live
「IG 授权完选不到账号」 IG 非专业号或未关联 FB 主页 让对方切专业号并关联主页
「X 授权后发帖 403」 App Permission 只有 Read 改成 Read and Write,并重新授权一次
「X 授权报错误码 32」 Type of App 不是 Native App 改为 Native App
「页面什么都看不到」 该用户未被分配任何账号 在账号台账的授权用户里勾上此人
「审核通过了但没生成发布任务」 路由矩阵匹配不到规则 确认账号已设市场,且路由有对应启用规则
「账号卡片显示失联」 Postiz 侧已无该账号 点「立即同步」确认;确实没了则重新绑定
「数据分析全是空的 / 无基线」 采集周期未到,或该平台计划无分析权限 等一个周期;X 无权限可设 DISABLE_X_ANALYTICS=true