通过SSH在树莓派4上使用OpenCV无法拍照的问题求助

问题场景 #

通过SSH在树莓派上运行OpenCV，摄像头已连接但无法正常拍摄显示图像，使用的代码如下：

import cv2

cam_port = 0
cam = cv2.VideoCapture(cam_port)

result, image = cam.read()


if result:
    cv2.imshow("img", image)
    cv2.imwrite("imasdf.png", image)
    cv2.waitKey(0)
    cv2.destroyWindow("img")
else:
    print("No image detected. Please! try again")

运行后触发以下错误：

Traceback (most recent call last):
  File "/home/ai/bacterium.py", line 10, in <module>
    cv2.imshow("img", image)
cv2.error: OpenCV(4.8.1) /io/opencv/modules/highgui/src/window.cpp:1272: error: (-2:Unspecified error) The function is not implemented. Rebuild the library with Windows, GTK+ 2.x or Cocoa support. If you are on Ubuntu or Debian, install libgtk2.0-dev and pkg-config, then re-run cmake or configure script in function 'cvShowImage'

已尝试安装libgtk2.0-dev，但系统提示已安装最新版本：

Reading package lists... Done
Building dependency tree... Done
Reading state information... Done
libgtk2.0-dev is already the newest version (2.24.33-2+rpt1).
0 upgraded, 0 newly installed, 0 to remove and 3 not upgraded.

重新运行代码后错误依旧。

解决方法 #

1. 移除图形显示逻辑（最简方案） #

SSH默认无图形环境，cv2.imshow()依赖图形后端支持，直接删除相关代码，仅保留图像保存功能：

import cv2

cam_port = 0
cam = cv2.VideoCapture(cam_port)

result, image = cam.read()

if result:
    cv2.imwrite("captured_image.png", image)
    print("图像已保存为captured_image.png")
else:
    print("未检测到图像，请重试")

2. 启用远程图形显示（需本地有图形界面） #

• 连接树莓派时开启X11转发：ssh -X pi@你的树莓派IP，确保树莓派安装xauth：sudo apt install xauth
• 改用matplotlib替代cv2.imshow显示图像：

import cv2
import matplotlib.pyplot as plt

cam_port = 0
cam = cv2.VideoCapture(cam_port)

result, image = cam.read()

if result:
    # 转换OpenCV的BGR格式为matplotlib支持的RGB格式
    image_rgb = cv2.cvtColor(image, cv2.COLOR_BGR2RGB)
    plt.imshow(image_rgb)
    plt.axis('off')
    plt.show()
    cv2.imwrite("captured_image.png", image)
else:
    print("未检测到图像，请重试")

3. 重新编译OpenCV（彻底解决图形后端依赖） #

若必须使用cv2.imshow()，需重新编译OpenCV并指定GTK后端：

1. 安装编译依赖：

sudo apt install build-essential cmake pkg-config libgtk2.0-dev libavcodec-dev libavformat-dev libswscale-dev

2. 下载并切换到指定版本源码：

git clone https://github.com/opencv/opencv.git
cd opencv
git checkout 4.8.1
mkdir build && cd build

3. 配置CMake参数：

cmake -D CMAKE_BUILD_TYPE=RELEASE -D CMAKE_INSTALL_PREFIX=/usr/local -D WITH_GTK=ON -D WITH_GTK2=ON ..

4. 编译并安装：

make -j$(nproc)
sudo make install
sudo ldconfig

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