使用fluent ffmpeg从流截取截图写入输出流失败问题排查

你的代码核心问题是没有等待FFmpeg进程完成，也未处理流的生命周期事件，导致FFmpeg还没把截图数据写完，程序就可能提前结束或者输出流被中断。

修正后的代码 #

const ffmpegProcess = ffmpeg(readStream)
  .setFfmpegPath(ffmpegPath)
  .outputOptions('-vframes 1')
  .outputOptions('-f image2pipe')
  .outputOptions('-vcodec png')
  .writeToStream(writeStream);

// 监听FFmpeg处理完成事件
ffmpegProcess.on('end', () => {
  // 手动关闭输出流，确保所有数据写入完成
  writeStream.end();
});

// 监听错误事件，排查隐性问题
ffmpegProcess.on('error', (err) => {
  console.error('FFmpeg执行出错:', err);
  writeStream.destroy(err); // 出错时销毁流，避免资源泄漏
});

关键说明 #

• 必须监听end事件：FFmpeg完成截图生成后才会触发该事件，此时再调用writeStream.end()，能保证所有截图数据都被写入输出流，不会出现数据丢失。
• 新增error监听：即使表面无报错，也可能存在输入流异常、FFmpeg参数隐性不兼容等问题，通过这个事件可以捕获具体错误信息。
• 如果输入流来自网络/文件，要确保输入流已正确开启且数据可读，输入流的异常也会导致FFmpeg无输出。

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