Cygwin环境下OpenCV VideoCapture打开视频失败，如何定位具体故障原因？

1. 如何获取VideoCapture打开失败的错误信息 #

OpenCV 3.4.x版本的cv::VideoCapture没有公开的错误码返回接口，你可以通过以下方式拿到调试信息：

• 在创建VideoCapture实例前添加cv::setLogLevel(cv::LOG_LEVEL_VERBOSE)，开启OpenCV的详细日志输出，底层视频IO后端的加载、解码、文件打开的错误信息都会直接输出到控制台。
• 你当前指定的cv::CAP_FFMPEG参数在你的环境中无效，建议去掉该参数让OpenCV自动匹配可用的后端，或者替换为cv::CAP_GSTREAMER。

2. 你当前无法打开视频的核心原因 #

查看你提供的OpenCV编译配置，Video I/O模块仅启用了GStreamer后端，没有FFMPEG后端支持：

• 你Windows系统中安装的FFmpeg命令行工具和OpenCV的FFMPEG后端完全无关，OpenCV需要在编译时链接Cygwin版本的FFmpeg开发库（libavcodec、libavformat等）才能生成FFMPEG后端，仅存在FFmpeg命令行程序无法被OpenCV调用。
• 你强制指定cv::CAP_FFMPEG参数时，OpenCV找不到对应的后端实现，直接返回打开失败。

3. 修复方案 #

方案一：使用现有GStreamer后端 #

• 在Cygwin包管理器中安装GStreamer解码插件：gstreamer1.0-plugins-base、gstreamer1.0-plugins-good、gstreamer1.0-plugins-bad、gstreamer1.0-plugins-ugly
• 创建VideoCapture时去掉cv::CAP_FFMPEG参数，或者替换为cv::CAP_GSTREAMER即可。

方案二：编译支持FFMPEG的OpenCV #

• 先在Cygwin包管理器中安装FFmpeg开发依赖：libavcodec-devel、libavformat-devel、libavutil-devel、libswscale-devel
• 重新编译OpenCV，CMake配置时确认WITH_FFMPEG选项被勾选，编译完成后检查配置输出的Video I/O部分存在FFMPEG条目即可。

调试用测试代码 #

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

int main( int argc, char* argv[] ) {
    if (argc < 2) {
        std::cout << "Usage: " << argv[0] << " <video_file_path>" << std::endl;
        return -1;
    }
    // 开启详细日志，输出打开过程中的所有错误信息
    cv::setLogLevel(cv::LOG_LEVEL_VERBOSE);

    // 自动匹配可用的视频后端
    cv::VideoCapture capture(argv[1]);
    if (!capture.isOpened())
    {
        std::cout << "Unable to open the file " << argv[1] << std::endl;
        exit(0);
    }
    std::cout << "Opened " << argv[1] << std::endl;
    capture.release();
    return 0;
}

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