如何修复OpenCV中cvtColor函数的报错问题？

先来看下你遇到的错误场景，你的代码和报错信息如下：

出错代码 #

import numpy as np
import cv2
cap = cv2.VideoCapture(0)
cap.set(3,640)
cap.set(4,480)
while(True):
    ret, frame = cap.read()
    frame = cv2.flip(frame, -1)
    gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    cv2.imshow('frame', frame)
    cv2.imshow('gray', gray)
    k = cv2.waitKey(30) & 0xff
    if k == 27:
        break
cap.release()
cv2.destroyAllWindows()

报错信息 #

Traceback (most recent call last):
File "<pyshell#1>", line 1, in
gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
error: (-215:Assertion failed) !_src.empty() in function 'cvtColor'

错误原因分析 #

这个报错的核心是传入cv2.cvtColor的frame是空的（None）。当cap.read()无法从摄像头获取帧时，返回的ret会是False，此时frame就是None，调用cvtColor时就会触发断言错误。

可能的触发场景：

• 摄像头被其他程序占用，无法读取
• 摄像头硬件连接问题
• 循环中某次读取帧失败（比如摄像头临时卡顿）

修复方案 #

我们需要在代码中添加两个关键判断，避免对空帧进行操作：

1. 初始化摄像头后，先检查摄像头是否成功打开
2. 每次读取帧后，判断是否读取成功，再执行后续操作

修改后的完整代码：

import numpy as np
import cv2

# 初始化摄像头
cap = cv2.VideoCapture(0)
# 检查摄像头是否成功打开
if not cap.isOpened():
    print("无法打开摄像头，请检查硬件连接或是否被其他程序占用")
    exit()

# 设置分辨率
cap.set(3, 640)
cap.set(4, 480)

while True:
    ret, frame = cap.read()
    # 判断是否成功读取帧
    if not ret:
        print("无法获取视频帧，退出循环")
        break
    
    frame = cv2.flip(frame, -1)
    gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    
    cv2.imshow('frame', frame)
    cv2.imshow('gray', gray)
    
    k = cv2.waitKey(30) & 0xff
    if k == 27:  # 按下ESC键退出
        break

# 释放资源
cap.release()
cv2.destroyAllWindows()

额外提示 #

• 如果还是报错，可以尝试把cv2.VideoCapture(0)中的0换成1、2等其他索引，有时候系统会给摄像头分配不同的设备编号
• 确保你的OpenCV版本和Python版本兼容，可以用pip install --upgrade opencv-python更新到最新稳定版

内容的提问来源于stack exchange，提问作者oyun kralı