Node.js+Express+FFmpeg实时水印视频流无法播放问题咨询

看起来你遇到的核心问题是手动处理Range请求时，响应头信息和FFmpeg处理后的实际流长度不匹配，导致浏览器提前关闭流，触发了未处理的错误。我来帮你拆解问题并给出修复方案：

问题根源分析 #

1. 响应头信息错误：你在处理Range请求时，用原视频的片段范围和文件大小设置了Content-Range和Content-Length，但FFmpeg加水印后的视频流长度和原片段完全不同——浏览器期望接收指定字节数的内容，实际收到的却是处理后的流，数据不匹配直接导致流关闭。
2. 缺失错误监听：FFmpeg命令执行出错时会抛出error事件，你的代码没有监听这个事件，导致Node.js因为未处理的错误崩溃。
3. 流式播放参数不足：原有的movflags参数虽然开启了片段化，但缺少关键的流式兼容配置，影响浏览器的播放解析。

修复后的代码 #

const express = require("express");
const fs = require("fs");
const ffmpeg = require("fluent-ffmpeg");
const ffmpegInstaller = require("@ffmpeg-installer/ffmpeg");

ffmpeg.setFfmpegPath(ffmpegInstaller.path);
const app = express();

app.get("/", function (req, res) {
  const videoPath = req.query.video;
  const WATERMARK_PATH = `${req.query.id}.png`;

  // 先校验文件是否存在，提前拦截错误
  if (!fs.existsSync(videoPath)) {
    return res.status(404).send("目标视频不存在");
  }
  if (!fs.existsSync(WATERMARK_PATH)) {
    return res.status(404).send("水印文件不存在");
  }

  // 设置视频流必要的响应头
  res.setHeader("Content-Type", "video/mp4");
  res.setHeader("Access-Control-Allow-Origin", "*"); // 按需开启跨域

  // 构建FFmpeg命令
  const ffmpegCmd = ffmpeg(fs.createReadStream(videoPath))
    .input(WATERMARK_PATH)
    .complexFilter(
      "overlay='x=if(eq(mod(n\\,18)\\,0)\\,sin(random(1))*w\\,x):y=if(eq(mod(n\\,18)\\,0)\\,sin(random(1))*h\\,y)'"
    )
    .outputOptions([
      "-movflags frag_keyframe+empty_moov+default_base_moof", // 优化流式播放兼容性
      "-f mp4"
    ])
    // 监听FFmpeg错误，避免程序崩溃
    .on("error", (err) => {
      console.error("FFmpeg处理出错:", err);
      if (!res.headersSent) {
        res.status(500).send("视频处理失败");
      } else {
        res.end();
      }
    })
    .on("end", () => {
      console.log("视频流传输完成");
      res.end();
    });

  // 将处理后的流pipe到响应
  ffmpegCmd.pipe(res, { end: true });
});

app.listen(3020, function () {
  console.log("服务运行在端口3020");
});

关键修改点说明 #

1. 移除手动Range处理：浏览器会自动处理视频流的分段请求，不需要手动计算原视频的片段范围——FFmpeg输出的流式MP4本身就支持浏览器的缓冲和续传逻辑。
2. 添加文件存在性校验：提前拦截视频或水印文件不存在的情况，避免FFmpeg无意义的报错。
3. 优化FFmpeg输出参数：新增default_base_moof参数，让MP4的元数据结构更适合流式播放，提升浏览器兼容性。
4. 添加错误监听：捕获FFmpeg的处理错误，优雅返回状态码，避免程序崩溃。

额外优化建议 #

• 如果需要支持精确的断点续传，可以通过解析Range头，计算对应的起始时间和时长，再用FFmpeg的-ss（起始时间）和-t（时长）参数处理，但需要先通过FFmpeg获取原视频的时长信息。
• 可以添加缓存机制，将处理后的视频临时存储到磁盘，避免重复处理相同请求，提升性能。
• 确保FFmpeg版本为最新，旧版本可能存在流式处理的兼容性问题。

内容的提问来源于stack exchange，提问作者Валера Денисенко