FFmpeg C++切换H.264编码器失败：无法找到设备及配置编码器

核心问题 #

你遇到的错误是因为FFmpeg默认选择了h264_v4l2m2m硬件编码器（依赖V4L2设备，如显卡编码模块），但你的系统没有可用的对应硬件设备，导致初始化失败。虽然你编译时启用了libx264，但当前FFmpeg环境未正确加载该编码器，且代码未指定使用它。

步骤1：确保FFmpeg正确集成libx264编码器 #

从你提供的ffmpeg -codecs输出看，仅存在h264_v4l2m2m编码器，说明libx264未被正确编译进FFmpeg，按以下步骤修复：

1. 安装libx264开发依赖：

   sudo apt-get update && sudo apt-get install libx264-dev
   

2. 重新编译FFmpeg，确保configure能检测到libx264：

   ./configure --enable-shared --enable-libx264 --enable-encoder=libx264 --enable-gpl --prefix=/usr/local/ffmpeg
   make -j$(nproc)
   sudo make install
   

3. 设置运行时库路径，让系统识别新编译的FFmpeg库：

   export LD_LIBRARY_PATH=/usr/local/ffmpeg/lib:$LD_LIBRARY_PATH
   

4. 验证编码器是否存在：

   ffmpeg -codecs | grep h264
   

   正确输出应包含libx264，示例：

   DEV.LS h264    H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10 (decoders: h264 h264_v4l2m2m ) (encoders: h264_v4l2m2m libx264 )
   

步骤2：修改代码强制使用libx264编码器 #

你的代码当前用avcodec_find_encoder(AV_CODEC_ID_H264)会优先返回系统中注册的第一个H.264编码器（即h264_v4l2m2m），需明确指定使用libx264：

修改add_stream函数的编码器查找逻辑 #

将：

*codec = avcodec_find_encoder(codec_id);

替换为：

*codec = avcodec_find_encoder_by_name("libx264");
if (!(*codec)) {
    fprintf(stderr, "Could not find libx264 encoder\n");
    exit(1);
}

此修改会直接定位到软件编码器libx264，避免选择硬件编码器。

优化输出格式设置 #

你当前指定输出格式为"h264"（裸H.264流），但输出文件名是video.mp4，建议改为MP4容器格式，兼容性更好：

avformat_alloc_output_context2(&enc_inf.oc, NULL, "mp4", filename);

若MP4格式初始化失败，再考虑其他格式，而非直接使用mpeg。

步骤3：补充编码器必要参数（可选） #

libx264需要基础参数才能正常工作，可在add_stream函数的视频编码设置部分添加：

// 针对libx264补充参数
if (c->codec_id == AV_CODEC_ID_H264) {
    c->profile = FF_PROFILE_H264_BASELINE; // 选择兼容的编码profile
    c->level = 30; // 对应编码level 3.0
}

确保STREAM_PIX_FMT设置为AV_PIX_FMT_YUV420P，这是H.264要求的通用像素格式。

验证修改 #

重新编译你的代码，运行后应不再出现h264_v4l2m2m相关错误，成功用libx264编码H.264视频。

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