运维手册
curl <api>/healthz# => {"ok":true,"deps":{"db":"ok","redis":"ok","wikifx_content":"ok"}}wikifx_content 为 not_configured 表示未配置 sidecar,不影响其它来源。
发布策略切换
Section titled “发布策略切换”| 操作 | 步骤 |
|---|---|
| 开启真发 | 验证草稿链路后,把 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 两侧一致性 |
运营反馈类问题对照表
Section titled “运营反馈类问题对照表”这些不是服务故障,而是平台侧配置或授权缺失。按下表定位,不必查日志:
| 运营的说法 | 真实原因 | 处理 |
|---|---|---|
| 「点绑定新账号报错」 | 该账号不在 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 |