树莓派4上OpenCV人脸检测代码输出空白屏问题求助

运行环境：树莓派4+Bullseye系统，Python 3.9.2，Raspberry Pi HQ Camera V1.0 2018
问题现象：使用Picamera2库示例代码做人脸检测，运行后仅显示空白窗口，无相机画面和人脸检测框，无报错信息；执行libcamera-hello命令可正常显示实时相机画面，原代码如下：

import cv2
from picamera2 import Picamera2

# Grab images as numpy arrays and leave everything else to OpenCV.
face_detector = cv2.CascadeClassifier("/home/pi/opencv-2.4.10/data/haarcascades/haarcascade_frontalface_default.xml") 
cv2.startWindowThread()

picam2 = Picamera2() 
picam2.configure(picam2.create_preview_configuration(main={"format": 'XRGB8888', "size": (640, 480)})) 
picam2.start()

while True:
    im = picam2.capture_array()

    grey = cv2.cvtColor(im, cv2.COLOR_BGR2GRAY)
    faces = face_detector.detectMultiScale(grey, 1.1, 5)

    for (x, y, w, h) in faces:
        cv2.rectangle(im, (x, y), (x + w, y + h), (0, 255, 0))

    cv2.imshow("Camera", im)

问题排查与修复方案 #

1. 颜色空间格式不匹配 #

Picamera2配置的XRGB8888格式通道顺序为「透明通道+R+G+B」，但代码中使用cv2.COLOR_BGR2GRAY是基于BGR格式的转换逻辑，直接处理会导致画面异常。

修复方式二选一：

• 直接将相机输出格式改为BGR888：

  picam2.configure(picam2.create_preview_configuration(main={"format": 'BGR888', "size": (640, 480)}))
  

• 保留XRGB8888格式，手动提取有效通道并转换为BGR：

  im = picam2.capture_array()[:, :, 1:]  # 移除第一个透明通道，得到RGB数据
  im = cv2.cvtColor(im, cv2.COLOR_RGB2BGR)  # 转换为OpenCV兼容的BGR格式
  

2. 缺少窗口事件处理 #

OpenCV的cv2.imshow需要配合cv2.waitKey()处理窗口事件循环，否则窗口会因无法刷新而显示空白，同时需要添加退出逻辑避免程序无限阻塞。

修复代码：
在cv2.imshow("Camera", im)后添加以下代码：

if cv2.waitKey(1) == ord('q'):
    break

并在循环结束后释放资源：

picam2.stop()
cv2.destroyAllWindows()

3. 验证人脸分类器文件有效性 #

确认级联分类器文件路径正确且文件存在，可添加验证代码提前排查问题：

face_detector = cv2.CascadeClassifier("/home/pi/opencv-2.4.10/data/haarcascades/haarcascade_frontalface_default.xml")
if face_detector.empty():
    print("人脸分类器文件加载失败，请检查路径是否正确！")
    exit()

内容的提问来源于stack exchange，提问作者sasha.c