问题排查
43-视频编辑 · 2026-10-12 · 2.4 KB
剪辑的失败几乎都能归到四类：素材（在不在 / 能不能读）· 合成引擎（随包 ffmpeg）· 时间轴（跑到成片外面 ⇒ 会被丢弃）· 导出（设置与磁盘）。
本专题手工维护（2026-10-12 建）；⚠ 报错文案以应用当前版本为准（本页快照 2026-10-12）。
一、先按顺序查（30 秒定因）
- 素材在不在：在面板里能预览 / 播放吗？⇒ 不能 ⇒ 回素材库重加 ✓
- 有没有画面片段：只有音频、只有字幕 ⇒ 必然失败（见 §三第一条）✓
- 时间轴有没有"跑到片子外面"：前面被剪短后，后面片段 / 叠加 / 字幕的起点可能超过成片 ⇒ 会被丢弃（有回执，不是崩溃）✓
- 成片设置：分辨率 / 帧率（只认 24 / 30）/ 是否烧录字幕 ✓
- 磁盘空间与写入权限（导出是往产物目录写文件）✓
二、按现象查（对照表）
| 现象 | 常见原因 | 处置 |
|---|---|---|
| 合成不动 / 报合成引擎相关错 | 随包合成引擎缺失或被安全软件拦截 | 正常装机不会缺（它随包分发并被校验）⇒ 按 §五 报障 ✓ |
| 一点就跑、很快就失败 | ① 没有画面片段 ② 素材路径已不存在 | 回 §一 第 1、2 条 ✓ |
| 某段 / 某叠加 / 某字幕"没出现在成片里" | 它的起点 ≥ 成片时长（前面被剪短了）⇒ 被丢弃 | 往前挪，或把前面的片段加长 ✓ |
| 字幕对不上口型 | 字幕时间窗按成片时间轴算，前面挪过片段 | 跟着挪；用预览核一遍 ✓ |
| 成片比例跟想的不一样 | 分辨率是「跟随首段」⇒ 第一段决定了画幅 | 手动定分辨率，或把那一段放最前 ✓ |
| 导出等很久 | 降噪（强力）· 高分辨率 · 长时长 · 变速带运动模糊 / 光流补帧 | 先用快速预览定稿；降噪降档 ✓ |
| 文件名怪怪的 | 输出名里的 \ / : * ? " < > 等字符（含竖线）被替换成 _，过长会截断 | 用简单名字 ✓ |
| 面板播放卡 / 起播慢 | 长素材会先做流式预览分片（缓存） | 等它转完；短视频更顺 ✓ |
三、报错原话逐条（照抄应用提示）
| 原话 | 意思 / 怎么办 |
|---|---|
本地引擎：视频剪辑至少需要一个画面素材片段。 | 主轨是空的（只有音频 / 字幕不算）⇒ 至少放一段画面 ✓ |
本地引擎：ffmpeg 不可用，无法合成剪辑成片 | 随包合成引擎缺失 / 被拦 ⇒ 重启应用；仍不行按 §五 报障 ✓ |
本地引擎：片段素材不存在：<路径> | 素材被移走 / 改名 ⇒ 回素材库重加 ✓ |
本地引擎：无法获取视频时长：<路径> | 该文件读不出时长（损坏 / 格式怪 / 没下完）⇒ 换一份素材 ✓ |
ffmpeg 合成剪辑失败：<原因> | 合成阶段失败 ⇒ 多半是素材本身病态 ⇒ 换一份 / 先把它转码一次 ✓ |
本地引擎：视频剪辑未生成输出文件 | 合成没落盘（磁盘满 / 权限 / 被杀进程）⇒ 查空间与安全软件 ✓ |
overlay「…」起点 Xs ≥ 成片 Ys，整块被丢弃 | 叠加层起点超过成片时长 ⇒ 往前挪 ✓ |
叠加音轨「…」起点 …，被丢弃 | 音轨起点超界 ⇒ 往前挪 ✓ |
字幕 「…」起点 … ≥ 成片 … | 字幕起点超过成片时长 ⇒ 往前挪 ✓ |
字幕 「…」时间窗无效 | 该字幕的起止不合法（时长 ≤ 0 等）⇒ 重设时间 ✓ |
字幕 「…」所在字幕轨被隐藏 | 这条字幕所在的轨道被隐藏了 ⇒ 取消隐藏 ✓ |
⚠ 上面那些"被丢弃"的提示是回执（告诉你哪一块没进成片），不是崩溃 ✓
四、与 AI 协同时可能撞上的四条（照抄）
| 原话 | 意思 |
|---|---|
节点 <id> 不是可承载时间线的节点（需 mediaRole=video-edit，或 video-process 且已带 params.edit） | 让 AI 存 / 载 / 校验时，对象必须是视频剪辑节点 ✓ |
画布没有视频剪辑节点（先 uc_do_create_media_node(templateId=local.video.edit, mediaRole=video-edit)） | 这张画布还没建剪辑节点 ✓ |
节点 <id> 还没有时间线数据（params.edit 为空…） | 节点是空的（没排过东西）⇒ 先在面板上排一段 ✓ |
写保护：磁盘上的时间线文件已在上次保存后被其它端（如渲染端自动保存）改写。…本次未写入。…请传 force:true 覆盖… | 工程档在别处被改过 ⇒ 先看一眼再决定是否覆盖 ✓ |
⚠ 在沙箱里让 AI 建 / 改 / 跑剪辑节点会被直接拒绝：【人机协同节点·禁止在沙箱施工】 —— 这是设计，不是 bug ✓
五、要报障时，把这四样一起给
- 报错原话（上面任意一条，越完整越好）✓
- 你素材的情况：几个片段 / 什么格式 / 多大 / 从哪来（本地文件 or 画布产物）✓
- 成片设置：分辨率 · 帧率 · 滤镜 / 降噪 / 锐化 · 是否多屏拼接 · 字幕是否烧录 ✓
- 时间轴截图（轨道上有哪些块、大致总时长）✓
来源：E:/workbuddyProj/unlimitCanvas/ai_manual/video_edit/04-问题排查.md