树莓派5上OpenCV VideoCapture无法捕获帧问题求助

通过VSCode SSH远程连接PiOS系统的树莓派5，开发OpenCV摄像头视频流捕获程序，能正常识别rev1.3版本OV5647摄像头，但捕获帧时Mat变量为空，提示Could not grab a frame!。

测试现象 #

• cheese工具报错：内存分配失败、缓冲池激活失败
• GST命令执行时出现数据流错误
• guvcview提示需先启动视频流
• 仅libcamera-hello --qt-preview可正常在PC端显示摄像头画面

相关代码示例 #

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

using namespace cv;
using namespace std;

int main() {
    VideoCapture cap(0);
    if (!cap.isOpened()) {
        cerr << "无法打开摄像头！" << endl;
        return -1;
    }

    cout << "摄像头已识别，开始捕获帧..." << endl;

    Mat frame;
    while (true) {
        cap >> frame;
        if (frame.empty()) {
            cerr << "Could not grab a frame!" << endl;
            break;
        }
    }

    cap.release();
    return 0;
}

系统信息 #

• 树莓派型号：Raspberry Pi 5
• 系统版本：Raspberry Pi OS Bookworm 64位
• OpenCV版本：4.5.x/4.8.x（可通过pkg-config --modversion opencv4查看）
• 摄像头型号：OV5647 rev1.3

核心原因 #

PiOS Bookworm默认采用libcamera作为摄像头框架，替代了旧版直接访问V4L2的模式，而传统OpenCV默认调用V4L2接口，无法直接兼容libcamera设备，导致帧捕获失败。

方法1：编译带libcamera支持的OpenCV #

1. 安装libcamera依赖：

sudo apt install libcamera-dev libcamera-apps-lite

2. 重新编译OpenCV（关键启用libcamera支持）：
   • 下载OpenCV源码，创建build目录并进入
   • 执行cmake配置：

   cmake -D CMAKE_BUILD_TYPE=RELEASE \
         -D CMAKE_INSTALL_PREFIX=/usr/local \
         -D WITH_LIBCAMERA=ON \
         -D WITH_V4L=ON \
         -D BUILD_EXAMPLES=OFF \
         ..
   

   • 编译安装：make -j4 && sudo make install

方法2：用libcamera-v4l2桥接兼容V4L2 #

无需重新编译OpenCV，通过libcamera提供的V4L2模拟层让OpenCV识别摄像头：

1. 加载v4l2loopback内核模块：

sudo modprobe v4l2loopback

2. 启动libcamera到V4L2的桥接：

libcamera-v4l2 --width 640 --height 480 --framerate 30

3. 此时OpenCV可通过VideoCapture cap(0)或cap("/dev/video0")正常捕获帧

方法3：直接调用libcamera API捕获帧 #

如果不需要OpenCV的后续处理，可直接用libcamera原生API编写捕获逻辑，示例片段：

#include <libcamera/libcamera.h>
#include <iostream>

using namespace libcamera;

int main() {
    CameraManager *cm = CameraManager::instance();
    cm->start();

    auto cameras = cm->cameras();
    if (cameras.empty()) {
        std::cerr << "无可用摄像头" << std::endl;
        return -1;
    }

    std::unique_ptr<Camera> camera = cm->get(cameras[0]->id());
    camera->acquire();

    // 配置摄像头参数、启动捕获逻辑（需补充完整libcamera流程）

    cm->stop();
    return 0;
}

编译时链接libcamera库：g++ -o capture capture.cpp -llibcamera

额外排查点 #

• 检查用户权限：确保当前用户在video组中，执行groups查看，缺失则执行sudo usermod -aG video $USER，重启后生效
• 确认CSI排线连接：树莓派5的CSI接口位置与旧版不同，需确保OV5647的排线插紧且方向正确
• 关闭其他摄像头占用程序：libcamera-hello等工具会独占摄像头，测试OpenCV前需完全关闭

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