树莓派摄像头运行OpenCV Python程序二次启动仅显示黑屏问题

1. 自动曝光参数适配错误：网传的0.25/0.75是部分平台的特殊映射值，树莓派OS使用的V4L2摄像头驱动对CAP_PROP_AUTO_EXPOSURE属性采用整数枚举规则：1对应手动曝光模式，3对应自动曝光模式。传入浮点值0.25/0.75会被自动取整为0，属于驱动未定义的无效值，导致曝光模式配置未真正生效，摄像头硬件寄存器会残留上次的长曝光配置。
2. 参数写入时序问题：程序退出前设置自动曝光后立即释放摄像头资源，V4L2驱动还未完成参数写入就断开了用户态连接，硬件曝光参数未被重置，第二次启动程序时摄像头仍处于异常配置状态。
3. 长曝光场景帧读取异常：900ms长曝光对应的帧率仅约1.1fps，第二次启动程序时未等第一帧完成曝光就开始读取，返回的是空帧或未完成曝光的黑屏帧，后续读取会一直卡在错误的帧缓冲区队列中。

• 替换自动曝光参数为V4L2标准枚举值：关闭自动曝光传入1，开启自动曝光传入3，避免无效值导致配置失败。
• 调整参数配置时序：每次调用set方法后校验返回值，确认配置生效；初始化时先开启自动曝光等待2秒让摄像头完成硬件复位，再切换到手动曝光模式；程序退出前设置完自动曝光后等待至少2秒，再释放摄像头资源。
• 初始化时清空帧缓冲区：正式采集前循环读取3-5帧并丢弃，清空残留的错误黑屏帧。
• 可选系统级复位：偶发异常时可直接调用v4l2-ctl -c auto_exposure=3命令从系统层重置摄像头参数，无需重启树莓派。

import numpy as np
import cv2
import time

# 指定摄像头索引为0，避免匹配到虚拟设备
camera = cv2.VideoCapture(0, cv2.CAP_V4L2)
if not camera.isOpened():
    camera.open(0, cv2.CAP_V4L2)

# 初始化先复位为自动曝光模式，等待硬件初始化
camera.set(cv2.CAP_PROP_AUTO_EXPOSURE, 3)
time.sleep(2)

# 配置采集参数
camera.set(cv2.CAP_PROP_FRAME_WIDTH, 1024)
camera.set(cv2.CAP_PROP_FRAME_HEIGHT, 1024)
# 切换到手动曝光模式
camera.set(cv2.CAP_PROP_AUTO_EXPOSURE, 1)
time.sleep(0.5)
# 设置900ms曝光
camera.set(cv2.CAP_PROP_EXPOSURE, 900)
time.sleep(1)

# 清空前5帧错误缓存
for _ in range(5):
    ret, frame = camera.read()

while True:
    ret, frame = camera.read()
    if not ret:
        continue
    img = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    cv2.imshow('frame', img)

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

# 切回自动曝光，等待参数写入完成
camera.set(cv2.CAP_PROP_AUTO_EXPOSURE, 3)
time.sleep(2)

camera.release()
cv2.destroyAllWindows()

内容的提问来源于stack exchange，提问作者Franz Carl Puchert