Node.js通过child_process调用FFmpeg加水印的问题及exec阻塞求助

我来帮你拆解这两个问题的原因和解决办法：

1. execFile调用FFmpeg时出现滤镜错误 #

你遇到的No such filter: '"overlay'错误，核心原因是execFile的参数传递逻辑和shell命令行不一样。

在终端里执行FFmpeg命令时，引号是用来告诉shell："overlay=10:10"是一个完整的参数，不要把它拆分开。但execFile是直接把参数数组传递给FFmpeg进程，不需要shell来解析，所以你如果把带引号的字符串（比如"-filter_complex \"overlay=10:10\""）当成一个参数，FFmpeg会把引号当成参数的一部分——也就是它会认为你要找的滤镜是"overlay（带前引号），自然就找不到这个滤镜了。

正确的做法是把每个独立的参数拆成数组的元素，不需要加任何引号：

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

execFile('ffmpeg', [
  '-i', 'input.mp4',
  '-i', 'logo.png',
  '-filter_complex', 'overlay=10:10',
  'output.mp4'
], (error, stdout, stderr) => {
  if (error) {
    console.error('处理出错:', error);
    console.error('FFmpeg输出:', stderr);
    return;
  }
  console.log('处理完成:', stdout);
});

这样execFile会正确把每个参数传递给FFmpeg，滤镜就能被正常识别了。

2. exec调用后父进程无法正常结束 #

用exec执行时父进程一直等待，是因为FFmpeg会往stderr输出大量的日志信息，而exec的子进程stdout/stderr缓冲区满了之后会阻塞，导致子进程无法退出，父进程就一直等着。

解决这个问题有两种常用方法：

• 方法一：手动消费stderr和stdout的输出，避免缓冲区阻塞：

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

const child = exec('ffmpeg -i input.mp4 -i logo.png -filter_complex "overlay=10:10" output.mp4', (error, stdout, stderr) => {
  if (error) {
    console.error('stderr: =============================', stderr);
    throw error;
  }
  console.log('stdout: ==========================', stdout);
});

// 消费stderr输出，防止缓冲区满
child.stderr.on('data', (data) => {
  // 可以选择打印或者忽略
  // console.log('FFmpeg日志:', data.toString());
});

// 同样消费stdout
child.stdout.on('data', (data) => {
  // console.log('FFmpeg标准输出:', data.toString());
});

console.log('here');

• 方法二：在exec选项里设置stdio: 'inherit'，让子进程直接使用父进程的输入输出流，这样就不会有缓冲区阻塞的问题：

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

exec('ffmpeg -i input.mp4 -i logo.png -filter_complex "overlay=10:10" output.mp4', { stdio: 'inherit' }, (error, stdout, stderr) => {
  if (error) {
    console.error('处理出错:', error);
    return;
  }
  console.log('处理完成');
});

console.log('here');

另外，其实对于FFmpeg这种会产生大量输出的进程，更推荐使用spawn（同样来自child_process），它是流式的，天生就不会有缓冲区阻塞的问题，用法和execFile类似，也是传递参数数组：

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

const ffmpeg = spawn('ffmpeg', [
  '-i', 'input.mp4',
  '-i', 'logo.png',
  '-filter_complex', 'overlay=10:10',
  'output.mp4'
]);

// 可以监听输出
ffmpeg.stderr.on('data', (data) => {
  console.log('FFmpeg日志:', data.toString());
});

ffmpeg.on('close', (code) => {
  if (code === 0) {
    console.log('视频处理完成');
  } else {
    console.error('处理失败，退出码:', code);
  }
});

console.log('here');

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