本文详解 Node.js 调用 ffprobe 通过标准输入（stdin）解析音频/视频流时因参数错误导致进程挂起的问题，重点纠正 -i pipe: 的误用，并提供稳定、可复用的流式探针封装方案。
本文详解 node.js 调用 ffprobe 通过标准输入（stdin）解析音频/视频流时因参数错误导致进程挂起的问题，重点纠正 `-i pipe:` 的误用，并提供稳定、可复用的流式探针封装方案。
在 Node.js 中通过 child_process.spawn 调用 ffprobe 分析媒体文件元数据时，若传入 ReadStream 或 Buffer，常遇到进程无限挂起（no exit, no output）的问题。根本原因在于 ffprobe 不支持 -i pipe: 这一写法——这与 ffmpeg 的行为不同，属于常见误区。
✅ 正确用法：使用 - 代替 -i pipe:
ffprobe 识别 - 作为标准输入（stdin）的标识符，而非 -i pipe:（后者是无效参数，会导致 ffprobe 等待不存在的命名管道或文件，从而卡死）。正确参数应为：
ffprobe -v quiet -print_format json -show_format -show_streams -show_chapters -
注意：- 必须作为最后一个参数（即输入源），且不能加 -i 前缀。
? 修复后的 probeStream 实现（关键改进点）
以下为优化后的 probeStream 函数，已移除冗余参数、修正 stdin 处理逻辑，并增强健壮性：
let probeStream = function (streamOrBuffer, params) {
const self = this;
return new Promise(async (resolve, reject) => {
const loglevel = self.logger.isDebug() ? 'debug' : 'error';
const args = [
'-v', 'quiet',
'-loglevel', loglevel,
'-print_format', 'json',
'-show_chapters',
'-show_format',
'-show_streams',
'-' // ✅ 关键：用 '-' 表示从 stdin 读取，而非 '-i pipe:'
];
const opts = { ...self._options.child_process, stdio: ['pipe', 'pipe', 'pipe'] };
// ⚠️ 显式设置 stdio 确保 stdin/stdout 可控（尤其在某些环境如 Docker/WSL2 下）
self.logger.debug("probeStream options: %s", args.join(" "));
let result = '';
const ffprobe = require('child_process').spawn('ffprobe', args, opts);
ffprobe.on('error', reject);
ffprobe.on('exit', (code, signal) => {
self.logger.debug("probeStream [exit] code: %s, signal: %s", code, signal);
if (code !== 0) {
reject(new Error(`ffprobe exited with code ${code}`));
}
});
ffprobe.stdout.on('data', (data) => {
result += data.toString();
});
ffprobe.stderr.on('data', (data) => {
const msg = data.toString().trim();
if (msg) self.logger.warn("ffprobe stderr:", msg);
});
// 写入数据并关闭 stdin
try {
if (streamOrBuffer instanceof Buffer) {
ffprobe.stdin.write(streamOrBuffer);
} else {
const buffer = await stream2Buffer(streamOrBuffer);
ffprobe.stdin.write(buffer);
}
ffprobe.stdin.end(); // ✅ 必须显式 end()，否则 ffprobe 不会触发解析
} catch (err) {
ffprobe.kill();
reject(err);
return;
}
// 等待 close 事件（表示子进程完全退出）
ffprobe.on('close', () => {
try {
// 尝试解析 JSON，避免空响应或格式错误
resolve(JSON.parse(result.trim() || '{}'));
} catch (e) {
reject(new Error(`Invalid ffprobe JSON output: ${e.message}`));
}
});
});
};
? 补充说明与注意事项
- 无需指定 -ar（采样率）：ffprobe 的作用是分析已有媒体流的元数据，而非重采样；-ar 是 ffmpeg 的转码参数，在 ffprobe 中无效且可能干扰解析。
-
stream2Buffer 安全性建议：生产环境应添加超时与大小限制，防止恶意大文件耗尽内存：
const MAX_BUFFER_SIZE = 100 * 1024 * 1024; // 100MB let size = 0; stream.on('data', (chunk) => { size += chunk.length; if (size > MAX_BUFFER_SIZE) throw new Error('Input stream exceeds max allowed size'); _buf.push(chunk); }); - 错误处理强化：监听 stderr 输出可捕获 ffprobe 的警告（如不支持的格式、损坏帧），便于调试。
- 环境兼容性：该方案已在 WSL2、Linux、macOS 验证；Windows 上需确保 ffprobe 在 PATH 中且权限正常。
✅ 总结
ffprobe 流式探针失败的核心症结在于错误沿用了 ffmpeg 的 -i pipe: 语法。牢记：ffprobe 使用 - 表示标准输入，且必须配合 stdin.end() 触发解析流程。结合正确的 stdio 配置、异常防护与 JSON 解析校验，即可构建高可用的媒体元数据提取模块。
