使用OpenCV将图片合成视频输出空文件的解决方法

开发者阿泽

2026-8-29

问题原因

生成空的无法播放的MP4文件，通常是以下几个原因导致的：

编码器参数配置错误：初始化VideoWriter时第二个参数传入-1的作用是唤起系统编码器选择弹窗，如果你没有在弹窗中选择适配MP4容器的编码器，或者运行环境无图形界面无法弹出选择框，会直接导致写入器初始化失败。就算你手动选择了编码器，如果选了XVID这类默认适配AVI容器的编码，也会因为容器和编码格式不匹配，导致生成的文件无法被播放器识别。
写入帧分辨率与初始化参数不匹配：初始化时传入的分辨率是(self.width, self.height)，如果images列表中的图片实际分辨率和这个值不一致，OpenCV不会自动做缩放适配，会直接跳过该帧的写入，最终生成空文件。另外要注意OpenCV读取的图片数组shape顺序是(高度, 宽度, 通道数)，而VideoWriter要求传入的分辨率参数顺序是(宽度, 高度)，如果宽高传反也会导致写入失败。
缺少初始化状态校验：你没有在写入前校验VideoWriter是否初始化成功，当出现编码器不支持、输出路径无写入权限、参数非法等问题时，写入器会处于未打开状态，后续的write操作完全不生效，最终只会得到0KB的无效文件。
额外可能导致无法播放的点：你设置的帧率为1fps，部分老旧播放器不支持帧率过低的MP4文件，会直接判定文件损坏无法播放。

修复方法

按照以下步骤调整代码即可：

不要使用-1作为编码器参数，直接指定MP4容器通用的mp4v编码，避免弹窗选择错误或者无GUI环境下初始化失败。如果你的OpenCV环境带H.264编码支持，也可以使用avc1编码生成兼容性更好的视频。
不要手动指定分辨率，直接从第一张待写入图片读取真实宽高，保证和写入帧尺寸完全匹配；如果图片尺寸不统一，写入前调用cv2.resize统一缩放到目标分辨率。
初始化写入器后立刻调用isOpened()方法校验状态，初始化失败时直接排查问题，不要继续执行写入逻辑。
帧率建议设置为24/25/30这类通用值，避免播放器兼容性问题。
写入前确认图片是uint8类型的BGR格式数组，如果是PIL读取的RGB格式、或者归一化到0-1范围的浮点数组，要先做格式转换再写入。

修复后的参考代码：

import cv2

# 从第一张待写入图片获取真实分辨率，避免参数错配
frame_height, frame_width = images[0].shape[:2]
# 指定MP4适配的mp4v编码器
fourcc = cv2.VideoWriter_fourcc(*'mp4v')
# 初始化写入器，帧率设为通用的25fps
video_writer = cv2.VideoWriter("output.mp4", fourcc, 25, (frame_width, frame_height))

# 校验写入器是否初始化成功
if not video_writer.isOpened():
    raise RuntimeError("视频写入器初始化失败，请检查编码器支持、输出路径写入权限")

for img in images:
    # 尺寸不匹配时强制缩放
    if img.shape[:2] != (frame_height, frame_width):
        img = cv2.resize(img, (frame_width, frame_height))
    # 如果是RGB格式图片，取消下行注释做通道转换
    # img = cv2.cvtColor(img, cv2.COLOR_RGB2BGR)
    video_writer.write(img)

video_writer.release()

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