本文旨在解决python opencv在写入MP4视频文件时遇到的常见问题，特别是输出文件大小为0KB的现象。我们将深入探讨导致此问题的主要原因，包括ffmpeg库的正确安装与配置，以及FourCC视频编码器代码的恰当选择，并提供详细的解决方案和实用代码示例，帮助开发者顺利完成视频写入操作。
在使用python的opencv库进行视频处理时，cv2.videowriter是用于将图像序列写入视频文件的核心功能。然而，许多开发者会遇到一个令人困惑的问题：当尝试将视频保存为mp4格式时，生成的视频文件大小为0kb，而同样的逻辑用于保存avi格式时却能正常工作。这通常指向两个核心问题：视频编码器的选择（fourcc代码）以及后端视频处理库（如ffmpeg）的配置。
核心问题分析：编码器与后端支持
cv2.VideoWriter函数需要指定输出视频的路径、FourCC编码器、帧率以及视频帧的尺寸。其基本语法如下：
video_writer = cv2.VideoWriter(filename, fourcc, fps, frameSize[, isColor])
其中，fourcc参数至关重要，它是一个4字符代码，用于指定视频流的编码器。当MP4文件输出为0KB时，通常意味着所选的编码器不被系统支持，或者OpenCV未能正确调用其依赖的视频处理后端。
1. FFmpeg的重要性
OpenCV本身并不包含所有视频编解码器。在大多数情况下，OpenCV依赖于外部的FFmpeg库来处理复杂的视频编解码任务，尤其是对于MP4、H.264等现代视频格式。如果FFmpeg未正确安装或未在其系统路径中配置，OpenCV将无法找到并使用所需的编码器，从而导致视频写入失败。
排查与配置步骤：
立即学习“Python免费学习笔记（深入）”；
- 检查FFmpeg安装： 确保FFmpeg已安装在您的操作系统上。您可以访问FFmpeg官方网站（ffmpeg.org）下载并安装最新版本。
- 配置系统PATH： 安装FFmpeg后，需要将其可执行文件所在的目录添加到系统的环境变量PATH中。这样，OpenCV才能在运行时找到并调用FFmpeg。
- 验证FFmpeg： 打开命令行或终端，输入ffmpeg -version。如果FFmpeg已正确安装并配置，您将看到其版本信息。
2. FourCC编码器选择
FourCC（Four Character Code）是一个四字符代码，用于标识视频编解码器。不同的编码器适用于不同的视频格式，且其可用性可能因操作系统、OpenCV的编译方式以及FFmpeg的安装情况而异。对于MP4格式，’mp4v’是一个常见的选择，但它可能并非总是最佳或最兼容的。
常见的MP4兼容FourCC代码：
- ‘mp4v’: MPEG-4编码器，OpenCV的默认MP4编码器之一。
- ‘XVID’: Xvid编码器，通常与AVI容器关联，但在某些情况下也可用于MP4。
- ‘H264’: H.264编码器，一种高效的视频编码标准。
- ‘DIVX’: DivX编码器，类似于Xvid。
尝试不同的FourCC代码：
当’mp4v’无法工作时，尝试其他兼容性更强的编码器是解决问题的有效方法。以下是一个示例代码片段，演示如何使用不同的FourCC代码：
import cv2 import numpy as np # 假设视频帧的尺寸和帧率 width, height = 640, 480 fps = 30 # 创建一个示例帧（例如，纯色帧） # 实际应用中，这里会是你的图像处理循环中的每一帧 dummy_frame = np.zeros((height, width, 3), dtype=np.uint8) # 可以添加一些颜色或形状来验证视频内容 cv2.putText(dummy_frame, "Test Frame", (width // 4, height // 2), cv2.FONT_HERSHEY_SIMPLEX, 1, (0, 255, 0), 2, cv2.LINE_AA) # 尝试不同的FourCC代码 fourcc_options = { 'MP4V': cv2.VideoWriter_fourcc(*'mp4v'), # MPEG-4 codec 'XVID': cv2.VideoWriter_fourcc(*'XVID'), # XVID codec 'H264': cv2.VideoWriter_fourcc(*'H264'), # H.264 codec (might need specific FFmpeg builds) 'MJPG': cv2.VideoWriter_fourcc(*'MJPG') # Motion-JPEG (often for .avi) } output_filename_base = "output_video" output_format = ".mp4" # 尝试用.mp4后缀，但编码器可能影响实际兼容性 for name, fourcc_code in fourcc_options.items(): video_path = f"{output_filename_base}_{name}{output_format}" print(f"Attempting to write with FourCC: {name} to {video_path}") video_writer = cv2.VideoWriter(video_path, fourcc_code, fps, (width, height)) # 检查VideoWriter是否成功打开 if not video_writer.isOpened(): print(f"Error: Could not open video writer for {name}. This FourCC might not be supported.") # 如果是H264且失败，可能是因为缺少特定FFmpeg编译支持 if name == 'H264': print("H264 might require specific FFmpeg configurations or a compatible OpenCV build.") continue # 写入几帧数据 for i in range(fps * 2): # 写入2秒的视频 # 在实际应用中，这里会是你的实际帧数据 frame_to_write = dummy_frame.copy() cv2.putText(frame_to_write, f"Frame: {i}", (10, 30), cv2.FONT_HERSHEY_SIMPLEX, 0.7, (255, 255, 255), 2, cv2.LINE_AA) video_writer.write(frame_to_write) video_writer.release() print(f"Successfully attempted to write {video_path}. Please check the file size.") print("nVideo writing attempts complete. Check the generated files.")
注意事项：
- ‘H264’编码器通常需要特定编译的OpenCV版本或FFmpeg支持，可能在某些系统上不直接可用。
- 即使文件后缀是.mp4，实际使用的编码器决定了视频内容的压缩方式。有些编码器（如MJPG）虽然可以写入.mp4文件，但其本质更适合AVI容器。为了更好的兼容性，建议根据所选FourCC调整文件后缀，例如MJPG通常与.avi搭配。
常见问题排查与最佳实践
除了上述两点，以下是一些在视频写入过程中值得注意的细节和排查方法：
- 检查isOpened()： 在创建VideoWriter对象后，务必使用video_writer.isOpened()方法检查其是否成功打开。如果返回False，说明VideoWriter未能初始化成功，后续的write()操作将无效。
- 确保release()调用： 在所有帧写入完成后，务务调用video_writer.release()。这个方法会释放资源，并确保所有缓存的数据都被写入到文件中，这是生成完整视频文件的关键步骤。
- 帧数据类型和尺寸： 确保写入的帧是OpenCV兼容的格式（通常是numpy.uint8类型，且通道顺序为BGR）和正确的尺寸，即与VideoWriter初始化时指定的frameSize一致。尺寸不匹配或数据类型不正确可能导致写入失败或视频损坏。
- OpenCV编译信息： 如果上述方法均无效，可以检查您的OpenCV安装是否支持FFmpeg。在Python中，可以通过print(cv2.getBuildInformation())查看OpenCV的编译信息，搜索其中关于FFmpeg支持的条目。
总结
OpenCV写入MP4文件为0KB的问题，核心在于FFmpeg后端支持和FourCC编码器选择。首先，确保FFmpeg已正确安装并配置到系统PATH中，这是OpenCV进行高级视频编解码的基础。其次，尝试不同的FourCC编码器，如’mp4v’、’XVID’或’H264’，以找到与您系统和OpenCV版本兼容的编码器。结合isOpened()检查和确保release()调用等最佳实践，可以有效解决视频写入问题，确保生成完整可播放的视频文件。
