FFmpeg 动态匹配音视频时长：自动循环延长或截断方法

本文详细讲解如何借助 FFmpeg 根据视频时长智能调整音频长度：当音频偏短时自动循环填充至视频全长，偏长时精准截断，实现音画严格同步，并附上可直接集成的 Node.js 实现代码。

在音视频合成场景中，如短视频制作、AI 自动成片导出等，经常需要将独立音频轨道与视频文件精确对齐。核心难点在于：音频长度与视频时长常常不一致。既不能简单静音填充，也不能粗暴裁剪导致关键内容丢失。FFmpeg 虽然具备灵活的流处理能力，但仅靠它还不够，必须结合 ffprobe 获取精确时长，再通过 -filter_complex 配合 apad 与 amix 实现动态适配。

核心策略详解：音频时长自适应

• 音频过短（小于视频时长）：采用 [b]apad 自动循环填充至视频长度，结合 amix=duration=first 以视频音频为基准混合；
• 音频过长（大于视频时长）：添加 -t ${videoDuration} 参数强制截断输出时长，防止多余音频残留；
• 完全匹配：跳过时长调整步骤，直接混音，提升处理效率。

注意：apad 默认会无限循环音频，如果未配合 amix=duration=first 或 -shortest 参数，可能导致输出时长异常延长。务必显式控制混合时长逻辑，确保音画同步。

完整 Node.js 实现（含错误处理机制）

export async function overlayAudio(id: number, music: Music) {
  console.log("start");
  const videoPath = path.join(__dirname, `../../../uploads/movie/${id}/result/movie/predfinal.mp4`);
  if (music === null) {
    return videoPath.match(/uploads(.*)/)[0];
  }
  const audioPath = path.join(__dirname, `../../../${music.audio}`);
  const outputVideoPath = path.join(__dirname, `../../../uploads/movie/${id}/result/movie/output.mp4`);
  const matchPath = outputVideoPath.match(/uploads(.*)/);
  // 并行获取音视频时长（秒，浮点数）
  const [videoDuration, audioDuration] = await Promise.all([
    execPromise(`ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "${videoPath}"`),
    execPromise(`ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 "${audioPath}"`)
  ]);
  const vDur = parseFloat(videoDuration.trim());
  const aDur = parseFloat(audioDuration.trim());
  let cmd: string;
  if (vDur > aDur) {
    // 音频循环延长至视频长度
    cmd = `ffmpeg -i "${videoPath}" -i "${audioPath}" ` +
          `-filter_complex "[0:a]volume=1[a];[1:a]volume=0.2[b];[b]apad[looped_audio];[a][looped_audio]amix=inputs=2:duration=first:dropout_transition=2" ` +
          `-c:v copy -c:a aac -strict experimental "${outputVideoPath}"`;
  } else if (vDur < aDur) {
    // 音频截断至视频长度
    cmd = `ffmpeg -i "${videoPath}" -i "${audioPath}" ` +
          `-filter_complex "[0:a]volume=1[a];[1:a]volume=0.2[b];[b]apad[looped_audio];[a][looped_audio]amix=inputs=2:duration=first:dropout_transition=2" ` +
          `-c:v copy -c:a aac -strict experimental -t ${vDur} "${outputVideoPath}"`;
  } else {
    // 时长相等，直接混音
    cmd = `ffmpeg -i "${videoPath}" -i "${audioPath}" ` +
          `-filter_complex "[0:a]volume=1[a];[1:a]volume=0.2[b];[b]apad[looped_audio];[a][looped_audio]amix=inputs=2:duration=first:dropout_transition=2" ` +
          `-c:v copy -c:a aac -strict experimental "${outputVideoPath}"`;
  }
  try {
    await execPromise(cmd);
    console.log("end!");
    return matchPath[0];
  } catch (error) {
    console.error("FFmpeg execution failed:", error);
    throw new Error(`Audio overlay failed: ${error.message}`);
  }
}

以上代码已包含完整的错误处理机制。逻辑清晰：首先并行获取音视频时长，再根据比较结果执行不同的分支处理。

关键细节详解

• 路径安全：所有文件路径使用双引号包裹，避免空格或特殊字符导致命令解析失败；
• 音量控制：设置 [0:a]volume=1 保持原视频音轨响度，[1:a]volume=0.2 降低背景音乐音量，避免掩盖主音频；
• 平滑过渡：dropout_transition=2 在音频切换处添加 2 秒淡出效果，避免声音突兀中断；
• 编码优化：使用 -c:v copy 直接复制视频流，无需重编码，大幅提升处理效率；
• 容错增强：通过 parseFloat() 与 .trim() 处理 ffprobe 输出中可能包含的换行或空格，避免 NaN 错误。

这套方案已在生产环境中稳定运行，支持毫秒级精度对齐，兼顾性能与鲁棒性。如需进一步优化——例如多段循环防重复感、动态音量均衡——可基于此框架扩展 afade、dynaudnorm 等滤镜。