OpenCV 3.4中使用VideoWriter编码H264视频的技术问题

阿华AIGC实验室

2026-5-19

解决OpenCV 3.4 VideoWriter H264编码问题（VS2017 C++环境）

我太懂你这种情况了——解码完全正常，轮到编码就掉链子，大概率是编码参数配置不对或者编译OpenCV时FFmpeg的编码组件没正确引入。结合你日常用FFmpeg手动编码的经验，咱们一步步排查解决：

1. 先把FourCC编码格式搞对

OpenCV的VideoWriter对H264的FourCC值要求很严苛，别随便写。你优先用标准的AVC1标识（这是H264的官方FourCC代码），也就是CV_FOURCC('A','V','C','1')；如果想用H264标识，得写成CV_FOURCC('H','2','6','4')，但前者兼容性更强，不容易踩坑。

别偷懒用十六进制值，可读性差还容易写错，老老实实用字符拼接的方式更稳妥。

2. 确认OpenCV编译时带了FFmpeg编码支持

虽然你能加载opencv_ffmpeg340_64.dll，但默认编译OpenCV可能只开了解码，没开编码。你可以跑这段代码验证一下：

#include <opencv2/opencv.hpp>
#include <iostream>

int main() {
    std::vector<cv::String> enc_backends;
    cv::VideoWriter::getEncoderBackends(enc_backends);
    std::cout << "可用编码后端：" << std::endl;
    for (auto& be : enc_backends) {
        std::cout << "- " << be << std::endl;
    }

    std::vector<int> supported_fourcc;
    cv::VideoWriter::getSupportedFourCCs(supported_fourcc);
    std::cout << "\n支持的FourCC编码：" << std::endl;
    for (int fc : supported_fourcc) {
        char c1 = (fc >> 0) & 0xFF;
        char c2 = (fc >> 8) & 0xFF;
        char c3 = (fc >> 16) & 0xFF;
        char c4 = (fc >> 24) & 0xFF;
        std::cout << "- " << c1 << c2 << c3 << c4 << std::endl;
    }
    return 0;
}

如果输出里看不到AVC1或H264，那就是编译时没开编码支持，得重新编译OpenCV：

CMake里务必勾选WITH_FFMPEG
确保BUILD_opencv_videoio是开启状态
用带编码功能的FFmpeg库文件（别用只带解码的阉割版）

3. VideoWriter初始化参数要严丝合缝

初始化时这几个参数错一个都不行：

输出视频的分辨率必须和你要写入的帧完全一致，差一个像素都可能失败
帧率要和你的跟踪软件输出帧率匹配，别瞎写
输出文件后缀优先用.mp4，MP4容器对H264的兼容性最好，别用.avi这类容易出问题的格式

给你个靠谱的初始化示例：

// 假设你的处理帧是1920x1080的彩色帧，帧率30
cv::VideoWriter writer;
int fourcc = cv::VideoWriter::fourcc('A','V','C','1');
// 参数依次是：输出路径、FourCC、帧率、分辨率、是否彩色
bool is_open = writer.open("track_output.mp4", fourcc, 30.0, cv::Size(1920, 1080), true);

if (!is_open) {
    std::cerr << "VideoWriter初始化失败！" << std::endl;
    return -1;
}

// 跟踪循环里写入帧
while (/* 你的跟踪逻辑条件 */) {
    // 处理得到当前帧frame...
    writer.write(frame);
}

writer.release(); // 必须调用！否则视频文件会损坏无法播放

4. 动态库的放置要到位

确保opencv_ffmpeg340_64.dll和你的exe在同一目录，或者在系统PATH里。另外，如果你是手动编译的FFmpeg，还要把FFmpeg的编码相关dll（比如avcodec-57.dll、avformat-57.dll，版本要和OpenCV3.4依赖的FFmpeg对应）也放到可访问路径，因为OpenCV的ffmpeg dll是依赖这些底层库的。