常见问题
视频内容资产引擎平台使用过程中的高频问题与排查入口。
看不到菜单
优先检查角色分配、菜单权限和按钮权限。
看得到页面但查不到数据
优先检查：
- 当前筛选条件
- 数据权限范围
- 记录状态是否还在处理中
看得到页面但按钮不能点
优先检查：
- 当前角色是否分配了对应按钮权限
- 当前记录状态是否允许该动作
- 当前用户是否在对应数据权限范围内
上传后资源迟迟不可用
优先检查上传任务状态、本地落盘状态、共享盘同步状态，以及相关异步任务日志。
如果是本地网关上传或本地资源登记，还要检查上传票据、登记回调和网关到云端的网络连通性。
如果是外网上传，还要检查上传 session 是否完成合并、目标网关是否在线、ECS 媒体入口是否能转发到该地区网关，以及云端资源登记回调是否成功。
直播录制任务一直待派发
优先检查目标网关是否在线、网关 ID 是否正确、直播地址是否可访问，以及当前直播平台是否限制访问。
直播录制完成但 MP4 不可用
优先检查 MP4 合并状态、录制切片完整性、共享盘剩余空间和合并进程日志。
直播录制素材上传后无法预览
优先检查：
- 录制文件是否完整
- 文件格式是否支持预览或转码
- 共享盘路径是否可被本地网关访问
- 预览或转码任务是否仍在处理中
如果只有开启 VPN 或代理的电脑无法预览，优先检查本地网关域名是否被代理接管。把对应网关域名或内网网段加入直连规则后，再访问 https://对应网关域名/api/video-collab/local/health 验证。
外网预览打不开
优先检查资源是否已有 480p 预览、资源归属网关是否在线、media.studiox-mkt.com 到目标地区网关是否可达、票据是否过期，以及目标文件是否已经同步到可承接的网关。
外网预览不可用不一定代表内网预览不可用。办公室内网预览和外网媒体入口是两条不同链路。
TTS 输出音频无法播放或下载
优先检查 TTS 任务是否成功、输出记录是否有共享盘相对路径、本地网关是否支持音频预览接口，以及当前电脑是否能访问本地网关。
如果电脑开启了 VPN、TUN 或全局代理，需要把当前区域本地网关域名加入直连规则。否则云端页面可以正常打开，但浏览器请求本地网关音频地址会失败。
上传后找不到文件
优先检查：
- 是否上传到了错误目录
- 当前列表是否需要刷新
- 当前用户是否有查看该目录的权限
- 文件是否进入了其他资源库而非当前模块
飞书通知没有发送
优先检查飞书账号绑定、群配置、通知开关和异步队列消费状态。
脚本分镜拆分没有结果
优先检查本地网关、Python worker、共享盘路径和回调接口状态。
如果任务成功但结果为空，还要检查源视频是否有有效画面或音轨，转写模型是否正常执行。
文案库无法从拆分结果生成
优先检查脚本分镜拆分任务是否已经完成、结果是否已经回写、分镜和转写内容是否为空，以及当前账号是否有文案库创建权限。
剪辑任务不能上传成片
优先检查当前任务是否已关闭、当前账号是否有成片上传权限、目标成片目录是否可用，以及本地网关上传链路是否正常。
删除后找不到数据
优先检查：
- 是否进入回收站
- 是否已被彻底删除
- 是否是目录删除导致整批资源一起进入回收状态
成片一直处于待修改或待审核
优先检查：
- 是否还有未完成的修改建议
- 是否重新提审成功
- 审核人员是否已经执行最终结论
推送记录一直待处理
优先检查本地网关推送心跳、推送执行器是否运行、广告账户授权是否有效，以及推送任务是否被网关认领。
推送部分成功
进入推送记录详情查看账户明细。通常需要按失败账户分别检查授权、账户状态、平台规则、素材规格和外部平台返回信息。
推送提示频率超限或请求过于频繁
这通常是外部平台限流。先看推送记录详情里的账户级失败原因和重试次数，再检查本地网关是否按退避策略重试。批量账户过多时，建议降低并发、拉开推送间隔或分批处理。
运维中心显示网关未知
未知 不等于故障。通常表示云端暂时拿不到足够证据判断本地能力状态。先看 WSS 是否在线，再看云端到网关 health、浏览器到网关、外网媒体入口到网关这几条链路是否分别可达。
Syncthing 或存储健康异常
优先检查共享盘根目录、预览目录、版本目录是否存在和可写，磁盘空间是否充足，Syncthing 文件夹是否能通过当前 API 策略查询。存储异常会影响上传、预览、直播录制、脚本分镜、TTS 输出和外网预览。
交付后资源无法复用
优先检查：
- 最终版成片和工程文件是否已经归档
- 标签是否补齐
- 相关直播录制素材或脚本分镜结果是否仍可访问
- 当前账号是否有资源库查看权限
飞书登录失败
优先检查：
- 当前飞书账号是否已绑定系统用户
- 授权是否过期
- 手机号是否已补充完整
- 账号是否处于启用状态
飞书卡片或通知没有响应
优先检查飞书应用回调地址、卡片交互回调、事件回调、消息权限和异步队列消费状态。