OpenCV imshow()显示单色窗口而非图像，无报错求助

问题场景 #

• 使用OpenCV调用摄像头时，imshow()显示单色窗口，无任何报错信息
• imwrite()保存的图像异常（无法正常显示）
• 摄像头在其他程序及其他Python代码中可正常工作，尝试过更换摄像头端口、重启PyCharm、重启电脑和摄像头均无效
• 后续测试发现：编写每5秒拍摄一次的程序时，第二次拍摄后恢复正常

原代码 #

import cv2
from time import sleep

camera = cv2.VideoCapture(0)

ret, frame = camera.read()
sleep(1)
cv2.imshow("frame", frame)
cv2.waitKey(0)
cv2.imwrite("image.jpg", frame)
cv2.destroyAllWindows()

问题原因 #

核心问题是摄像头未完成初始化就被调用读取帧。多数USB摄像头需要短暂时间完成硬件启动、自动对焦/曝光校准，打开摄像头后立刻执行read()，会获取到未初始化的异常帧（单色、全黑/白等），此时ret值大概率为False（表示帧读取失败），自然会导致imshow显示异常、imwrite保存失败。

解决方法 #

方法1：循环读取丢弃初始化帧 #

通过循环读取几帧丢弃，让摄像头完成初始化后再读取有效帧：

import cv2

camera = cv2.VideoCapture(0)
# 循环读取3帧，跳过初始化阶段的无效帧
for _ in range(3):
    camera.read()
# 读取有效帧
ret, frame = camera.read()
if ret:
    cv2.imshow("frame", frame)
    cv2.waitKey(0)
    cv2.imwrite("image.jpg", frame)
else:
    print("读取帧失败，请检查摄像头连接")
# 释放摄像头资源
camera.release()
cv2.destroyAllWindows()

方法2：等待初始化+循环重试读取 #

给摄像头足够初始化时间，同时检查读取状态，确保获取有效帧：

import cv2
from time import sleep

camera = cv2.VideoCapture(0)
sleep(2)  # 延长初始化等待时间，根据摄像头调整时长
# 循环重试，直到读取到有效帧
ret, frame = camera.read()
while not ret:
    ret, frame = camera.read()

cv2.imshow("frame", frame)
cv2.waitKey(0)
cv2.imwrite("image.jpg", frame)
camera.release()
cv2.destroyAllWindows()

关键注意事项 #

• 必须检查ret值：只有ret为True时，frame才是有效图像数据
• 程序结束时务必调用camera.release()，避免摄像头资源被占用
• 不同摄像头初始化时长不同，可根据实际情况调整循环次数或等待时间

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