Node.js中如何获取ffmpeg stdout缓冲流及空数组问题排查

问题背景 #

在Node.js中通过spawn执行ffmpeg命令，意图将处理后的视频数据存入Buffer，但ffmpegSpawn.stdout的data事件未触发，最终得到空数组且无报错。改用输出到本地文件的参数时，ffmpeg能正常生成MP4文件，但无法通过stdout获取输出流；直接监听子进程的data事件也无效果。

核心原因分析 #

1. MP4封装格式限制：默认情况下，MP4的封装器（muxer）需要生成完整的索引元数据（moov原子）才能完成输出，会等到整个视频处理完毕才一次性输出数据，而非流式输出。部分MP4封装器甚至不支持直接输出到stdout。
2. 错误监听逻辑错误：原代码仅监听stderr的error事件，但ffmpeg的运行日志、警告和错误信息均输出到stderr流，未监听stderr的data事件会导致无法捕获潜在的运行错误。
3. 事件监听顺序问题：原代码先向子进程stdin写入数据，再注册stdout的监听器，可能错过ffmpeg早期的输出数据。

解决方案 #

1. 添加ffmpeg流式输出参数 #

为MP4格式添加强制流式输出的参数，让ffmpeg可以分片输出数据到stdout：
-movflags frag_keyframe+empty_moov+default_base_moof
各参数作用：

• frag_keyframe：每个关键帧对应一个视频分片，支持流式输出
• empty_moov：生成空的moov元数据块，无需等待所有数据处理完成即可输出
• default_base_moof：将moov元数据块放在数据块（mdat）之前，适配流式传输场景

2. 修正事件监听逻辑 #

• 先注册stdout、stderr和子进程的各类事件监听器，再向stdin写入数据
• 监听stderr的data事件，查看ffmpeg的运行日志，排查潜在问题
• 子进程本身没有data事件，需监听stdout的data事件获取输出数据

3. 修正后的完整代码 #

const { spawn } = require('child_process');

// 输入视频Buffer（Uint8Array类型）
const videoBuffer = /* 你的输入视频数据 */;
let outputChunks = [];

// 创建ffmpeg子进程，添加流式MP4参数
const ffmpegSpawn = spawn(ffmpegPath, [
  "-i", "-",
  "-filter:v", "crop=500:500:50:50",
  "-preset", "fast",
  "-movflags", "frag_keyframe+empty_moov+default_base_moof",
  "-f", "mp4",
  "-"
]);

// 监听stdout数据
ffmpegSpawn.stdout.on("data", (chunk) => {
  console.log(`收到数据块：${chunk.length}字节`);
  outputChunks.push(chunk);
});

// 监听ffmpeg运行日志（stderr）
ffmpegSpawn.stderr.on("data", (log) => {
  console.log(`ffmpeg日志：${log.toString()}`);
});

// 监听子进程退出事件
ffmpegSpawn.on("close", (exitCode) => {
  console.log(`子进程退出，代码：${exitCode}`);
  if (exitCode === 0) {
    const finalBuffer = Buffer.concat(outputChunks);
    console.log(`最终输出Buffer大小：${finalBuffer.length}字节`);
    // 此处可处理finalBuffer
  } else {
    console.error(`ffmpeg运行失败，退出码：${exitCode}`);
  }
});

// 监听子进程启动错误
ffmpegSpawn.on("error", (err) => {
  console.error(`子进程启动失败：${err.message}`);
});

// 写入输入数据并关闭stdin
ffmpegSpawn.stdin.write(videoBuffer);
ffmpegSpawn.stdin.end();

内容的提问来源于stack exchange，提问作者Radespy