opencv-python保存H264编码MP4视频报错，安装libx264-dev无效如何解决

1. MP4容器对H264编码的标准fourcc标识为avc1，你代码中写的h264只适用于部分特殊封装格式，直接用在MP4下会触发ffmpeg格式不匹配警告。
2. PyPI源默认预编译的opencv-python包自带阉割版的ffmpeg，默认不集成x264编码支持，即便系统安装了libx264-dev也无法被opencv调用。
3. Docker基础镜像缺少完整的ffmpeg运行依赖，仅装libx264-dev无法提供编码能力。

步骤1：修正代码中的fourcc配置 #

修改VideoWriter的fourcc参数为MP4+H264对应的标准值：

import cv2

def save_video(frames):
    fps = 30
    video_path = '/home/save_test.mp4'
    # 替换h264为avc1
    fourcc = cv2.VideoWriter_fourcc(*'avc1')
    video_writer = cv2.VideoWriter(video_path, fourcc, fps, (112, 112))

    for frame in frames:
        video_writer.write(frame)

    video_writer.release()

步骤2：安装Docker环境完整依赖 #

在Dockerfile中或者容器内执行以下命令安装完整依赖：

apt update && apt install -y --no-install-recommends \
ffmpeg \
libx264-dev \
libsm6 \
libxext6 \
build-essential

步骤3：替换支持ffmpeg的opencv版本 #

先卸载原有opencv包：

pip uninstall -y opencv-python opencv-contrib-python

两种可行的安装方案二选一：

• 方案A：安装支持系统ffmpeg的opencv-headless版本

pip install opencv-python-headless==4.5.1.48

• 方案B：如果方案A仍不生效，使用conda安装opencv（会自动绑定带x264支持的ffmpeg）

conda install -c conda-forge opencv==4.5.1

步骤4：验证配置生效 #

运行以下代码确认opencv已识别ffmpeg和x264编码：

import cv2
# 打印构建信息，搜索FFmpeg字段，确认状态为YES
print(cv2.getBuildInformation())

如果opencv的编码问题始终无法解决，可以直接使用ffmpeg-python库调用系统ffmpeg写H264视频，性能和兼容性更好：
首先安装依赖：

pip install ffmpeg-python

对应代码示例：

import ffmpeg

def save_video(frames, fps=30, output_path='/home/save_test.mp4'):
    height, width, _ = frames[0].shape
    process = (
        ffmpeg
        .input('pipe:', format='rawvideo', pix_fmt='bgr24', s=f'{width}x{height}', r=fps)
        .output(output_path, vcodec='libx264', pix_fmt='yuv420p', crf=23)
        .overwrite_output()
        .run_async(pipe_stdin=True)
    )
    for frame in frames:
        process.stdin.write(frame.tobytes())
    process.stdin.close()
    process.wait()

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