视频导出失败、黑屏或时长不对：检查编码与帧率链路

现象与适用范围

视频节点读取或合成失败，或者输出文件存在但浏览器不能播放、时长异常、没有声音。本页围绕媒体处理层排查，不把这些问题全部归因于生成模型。

检索用原文或片段（具体编号、数值和文件名随环境变化）：

Unknown encoder
Invalid argument
VideoCombine

已核对的依据

VideoHelperSuite README 说明加载端的帧率/抽帧设置和合成端的 frame_rate、loop_count、pingpong、音频、格式、保存选项；高级预览可能转码。保存文件、浏览器播放与工作流元数据是三项不同能力。 R02 FFmpeg 分别说明编码器与容器支持。FFmpeg 编码器 FFmpeg 格式

需要区分的情况

1. 加载时抽帧或强制帧率与合成帧率不同，或 loop_count、pingpong 改变了显示帧数及顺序，实际时长与预期不同。

2. 所选容器、编码器或像素格式不被当前 FFmpeg 构建/浏览器支持。

3. 音频没有连接、保存写入失败，或者高级预览仍在转码而非后端生成没有完成。

建议的操作顺序

以下顺序是基于上述资料整理的诊断方案，不代表上游已经为你的环境确认了原因。

第 1 步。 先查看最终图像帧是否有效，确认问题发生在模型输出之前还是视频编码之后。

第 2 步。 记录实际帧数、加载抽帧设置、合成帧率、loop_count 和 pingpong。仅在单次正向播放且未重复时，才用“帧数÷输出帧率”估算基础时长，再与编码文件核对；重复或反向播放会改变预期。

第 3 步。 保存 FFmpeg stderr，用节点文档允许的常见格式导出极短样例，再分别验证文件播放器和浏览器。

第 4 步。 核对音频输入、save_output、文件路径与元数据选项，避免把临时预览当成最终交付视频。

如何判断处理有效

文件可在目标播放环境打开，分辨率、帧数、时长和音轨均符合本次设置；另行确认是否需要保留工作流元数据。

注意事项与尚未确认的部分

改编码器或像素格式可能改变兼容性、质量和文件体积；此处没有实测任何硬件编码性能。

资料复核日期：2026-09-25。本站未执行此工作流，未进行 GPU、视频编码、播放、最低显存或耗时测试。

原始资料

• R02 · VideoHelperSuite README。核对：2026-09-25。
• FFmpeg 编码器文档。核对：2026-09-25。
• FFmpeg 格式文档。核对：2026-09-25。

相关排查与操作

• FFmpeg 找不到：终端可用不代表节点进程也能找到
• No space left on device：区分模型、临时目录与输出盘
• VideoHelperSuite 参考：读取帧、处理音频、合成视频与保存