Node.js用fluent-ffmpeg拆分WAV立体声为单声道报错排查

我正在开发一款Node.js程序，用于将音频轨道转换为.wav格式，但在将生成的立体声WAV文件拆分为左、右声道的单声道WAV文件时遇到困难，期望实现如下结构：

FileName.wav (Stereo)
FileName_left.wav (Left Channel Mono)
FileName_right.wav (Right Channel Mono)

我尝试了多种方法，最终采用基于fluent-ffmpeg的函数实现，但当前代码在try-catch块中抛出错误：
"Error occurred while processing the audio: No output specified"
我尝试添加.output(${outputLeft})，也在-map参数的left.wav前添加路径如"./"，均无法解决输出指定问题，请问该错误原因是什么？

代码如下：

const ffmpeg = require("fluent-ffmpeg");
async function splitChannels(infile) {
    console.log(`Stereo To Mono Conversion Started!`);
    const outputLeft = infile.replace(".wav", "_left.wav");
    const outputRight = infile.replace(".wav", "_right.wav");

    try {
        // Split the left channel
        await new Promise((resolve, reject) => {
            ffmpeg(infile)
                .outputOptions([
                    '-filter_complex "[0:a:{k}]channelsplit=channel_layout=stereo[left][right]"',
                    '-c:a pcm_s16le',
                    `-map "[left]" left.wav`,
                    `-map "[right]" right.wav`,
                ])
                .on('error', (err) => {
                    console.log(`An error occurred while splitting the left channel: ${err.message}`);
                    reject(err);
                })
                .on('end', () => {
                    console.log('Channels splitted!');
                    resolve();
                })
                .run();
        });
    } catch (err) {
        console.error('Error occurred while processing the audio:', err.message);
    }
}

错误原因与解决方案 #

错误原因 #

1. fluent-ffmpeg API规范问题：该库要求必须通过.output()方法显式声明输出文件，你直接在outputOptions的-map参数后写文件名的方式不符合API要求，导致库无法识别输出目标。
2. 滤镜语法错误：你的filter_complex参数里有多余的{k}占位符，这会导致ffmpeg无法正确解析滤镜规则，进一步加剧输出配置的异常。

修正后的代码 #

下面是两种可行的修正写法：

写法1：分两次指定输出文件

const ffmpeg = require("fluent-ffmpeg");
async function splitChannels(infile) {
    console.log(`Stereo To Mono Conversion Started!`);
    const outputLeft = infile.replace(".wav", "_left.wav");
    const outputRight = infile.replace(".wav", "_right.wav");

    try {
        await new Promise((resolve, reject) => {
            ffmpeg(infile)
                // 配置声道拆分滤镜
                .outputOptions('-filter_complex "[0:a]channelsplit=channel_layout=stereo[left][right]"')
                // 左声道输出配置
                .output(outputLeft)
                .outputOptions('-map "[left]"', '-c:a pcm_s16le')
                // 右声道输出配置
                .output(outputRight)
                .outputOptions('-map "[right]"', '-c:a pcm_s16le')
                .on('error', (err) => {
                    console.log(`拆分声道时出错: ${err.message}`);
                    reject(err);
                })
                .on('end', () => {
                    console.log('声道拆分完成!');
                    resolve();
                })
                .run();
        });
    } catch (err) {
        console.error('音频处理出错:', err.message);
    }
}

写法2：集中配置滤镜后指定多输出

const ffmpeg = require("fluent-ffmpeg");
async function splitChannels(infile) {
    console.log(`Stereo To Mono Conversion Started!`);
    const outputLeft = infile.replace(".wav", "_left.wav");
    const outputRight = infile.replace(".wav", "_right.wav");

    try {
        await new Promise((resolve, reject) => {
            ffmpeg(infile)
                .outputOptions([
                    '-filter_complex "[0:a]channelsplit=channel_layout=stereo[left][right]"',
                    '-c:a pcm_s16le'
                ])
                // 指定左声道输出文件并映射流
                .output(outputLeft)
                .outputOptions('-map "[left]"')
                // 指定右声道输出文件并映射流
                .output(outputRight)
                .outputOptions('-map "[right]"')
                .on('error', (err) => {
                    console.log(`拆分声道时出错: ${err.message}`);
                    reject(err);
                })
                .on('end', () => {
                    console.log('声道拆分完成!');
                    resolve();
                })
                .run();
        });
    } catch (err) {
        console.error('音频处理出错:', err.message);
    }
}

关键说明 #

• 必须通过.output()方法显式声明每个输出文件，这是fluent-ffmpeg的强制要求，不能仅在outputOptions中隐式指定文件名。
• 移除了滤镜参数中的无效{k}占位符，确保ffmpeg能正确解析声道拆分规则。
• 每个输出文件对应单独的-map参数，保证只提取对应声道的音频流。

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