如何解决Python OpenCV运动检测项目中的ValueError: not enough values to unpack (expected 3, got 2)错误

嘿，我看你在运行这个@dhruvmarathe开发的Python+OpenCV运动检测项目时遇到了问题，虽然你没明确写出具体报错信息，但根据你的代码，我能指出几个大概率导致故障的点，帮你搞定：

常见问题分析 #

• 摄像头调用失败导致frame为空：如果cv2.VideoCapture(0)没法成功启动摄像头，video.read()返回的frame会是None，后面执行cv2.cvtColor直接就会崩掉。
• OpenCV版本兼容问题：新版本的OpenCV里，cv2.findContours的返回值已经从三个变成两个了，你原来写的(_,cnts,_)会触发解包错误。
• 膨胀操作无效：iterations=0等于没做膨胀处理，没法让运动区域的轮廓更连贯，检测效果会很差。

修复后的完整代码 #

import cv2
import time

first_frame = None
# 先检查摄像头能不能正常打开
video = cv2.VideoCapture(0)
if not video.isOpened():
    print("糟了，没法打开摄像头！检查下设备连接或者权限哦")
    exit()

while True:
    check, frame = video.read()
    # 每次读取帧都要确认是否有效
    if not check or frame is None:
        print("读取摄像头帧失败，退出啦")
        break
    
    gray = cv2.cvtColor(frame, cv2.COLOR_BGR2GRAY)
    gray = cv2.GaussianBlur(gray, (21, 21), 0)
    
    if first_frame is None:
        first_frame = gray
        continue
    
    delta_frame = cv2.absdiff(first_frame, gray)
    thresh_delta = cv2.threshold(delta_frame, 30, 255, cv2.THRESH_BINARY)[1]
    # 把膨胀迭代次数改成1，让轮廓更清晰
    thresh_delta = cv2.dilate(thresh_delta, None, iterations=1)
    
    # 适配新OpenCV版本的findContours返回值
    cnts, _ = cv2.findContours(thresh_delta.copy(), cv2.RETR_EXTERNAL, cv2.CHAIN_APPROX_SIMPLE)
    
    for contour in cnts:
        if cv2.contourArea(contour) < 1000:
            continue
        (x, y, w, h) = cv2.boundingRect(contour)
        cv2.rectangle(frame, (x, y), (x+w, y+h), (0, 255, 0), 3)
    
    cv2.imshow('frame', frame)
    cv2.imshow('Capturing', gray)
    cv2.imshow('delta', delta_frame)
    cv2.imshow('thresh', thresh_delta)
    
    key = cv2.waitKey(1)
    if key == ord('q'):
        break

video.release()
cv2.destroyAllWindows()  # 别忘了关掉所有窗口，不然可能残留进程

关键修改说明 #

1. 摄像头有效性检查：启动摄像头后立刻用video.isOpened()确认，避免后续无效操作。
2. 帧读取校验：每次循环都检查frame是否有效，防止摄像头意外断开导致崩溃。
3. 兼容新版本OpenCV：调整findContours的解包方式，适配v4.x及以上版本的返回值。
4. 优化膨胀操作：把迭代次数改成1，让运动区域的轮廓更连贯，提升检测精度。
5. 补充窗口销毁：程序结束时调用cv2.destroyAllWindows()，彻底清理OpenCV资源。

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