Windows下fluent-ffmpeg生成HLS报错：Output format hls不可用

你遇到的核心矛盾是：Windows 11下通过fluent-ffmpeg调用FFmpeg 7.0生成HLS时报错Output format hls is not available，但命令行直接执行FFmpeg转HLS正常，Mac环境下代码也能正常运行。这说明问题出在fluent-ffmpeg的Windows环境配置或参数传递逻辑，而非FFmpeg本身的功能缺失。

1. 显式指定Windows版FFmpeg的绝对路径 #

Chocolatey安装的FFmpeg默认路径为C:\ProgramData\chocolatey\bin\ffmpeg.exe，必须在代码中明确指定，避免fluent-ffmpeg误调用系统中其他版本的FFmpeg（比如未编译HLS模块的旧版本）：

const ffmpeg = require('fluent-ffmpeg');
// 注意Windows路径的转义，或使用正斜杠
ffmpeg.setFfmpegPath('C:\\ProgramData\\chocolatey\\bin\\ffmpeg.exe');
// 或用正斜杠写法：'C:/ProgramData/chocolatey/bin/ffmpeg.exe'

2. 调整HLS参数的添加顺序 #

Windows环境下fluent-ffmpeg对参数顺序的敏感度更高，必须先指定-f hls输出格式，再添加hls_segment_filename等HLS专属参数。错误的顺序会导致FFmpeg无法识别HLS格式，示例正确代码结构：

const inputFile = 'source.mp4';
const outputDir = './hls_output';

ffmpeg(inputFile)
  // 多分辨率转码的filter_complex配置
  .outputOptions([
    '-filter_complex', '[0:v]split=4[v1][v2][v3][v4];[v1]scale=1920:1080[v1out];[v2]scale=1280:720[v2out];[v3]scale=854:480[v3out];[v4]scale=640:360[v4out]',
    '-map', '[v1out]', '-map', '0:a', '-c:v', 'libx264', '-c:a', 'aac', '-b:v:0', '5000k',
    '-map', '[v2out]', '-map', '0:a', '-c:v', 'libx264', '-c:a', 'aac', '-b:v:1', '2500k',
    '-map', '[v3out]', '-map', '0:a', '-c:v', 'libx264', '-c:a', 'aac', '-b:v:2', '1000k',
    '-map', '[v4out]', '-map', '0:a', '-c:v', 'libx264', '-c:a', 'aac', '-b:v:3', '500k',
    // 先声明HLS输出格式
    '-f', 'hls',
    // 再添加HLS专属参数
    '-hls_segment_filename', `${outputDir}/%v/segment_%03d.ts`,
    '-hls_time', '10',
    '-hls_list_size', '0',
    '-master_pl_name', 'master.m3u8',
    '-var_stream_map', 'v:0,a:0 v:1,a:1 v:2,a:2 v:3,a:3'
  ])
  .output(`${outputDir}/%v/stream.m3u8`)
  .on('end', () => console.log('HLS转码完成'))
  .on('error', (err) => console.error('错误:', err))
  .run();

3. 验证FFmpeg的HLS支持并更新依赖 #

• 命令行执行以下命令，确认FFmpeg本身支持HLS输出：

  ffmpeg -formats | findstr hls
  

  输出包含E hls（E代表可输出）则说明功能正常。
• 更新fluent-ffmpeg到最新版本，修复旧版本对Windows环境的适配问题：

  npm update fluent-ffmpeg
  

4. 规范Windows路径写法 #

指定输出目录和分段文件名时，优先使用正斜杠/代替反斜杠\，避免路径转义错误导致播放列表无法生成：

// 推荐写法，无需转义
'-hls_segment_filename', `${outputDir}/%v/segment_%03d.ts`,

Mac环境下fluent-ffmpeg会自动识别系统默认的FFmpeg路径，且参数顺序容错性更高；而Windows环境下，若未显式指定FFmpeg路径，fluent-ffmpeg可能调用PATH中不兼容的版本，同时参数顺序错误会直接导致FFmpeg无法识别HLS格式，触发Output format hls is not available错误。

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