如何修复OpenCV中detectAndDecodeCurved的二维码识别崩溃问题？

问题本质 #

你遇到的三类错误都是无效检测结果触发的后续处理异常：

• 错误1：未检测到有效二维码轮廓（面积为0），解码阶段触发断言失败
• 错误2：检测出的坐标超出图像范围，导致floodFill操作越界
• 错误3：前两类错误引发的未捕获C++底层异常

修复方案 #

从输入校验、资源复用、异常防护三个维度修改代码：

• 校验摄像头帧有效性，跳过读取失败的空帧
• 把QRCodeDetector对象初始化移到循环外，避免重复初始化的开销和潜在问题
• 用异常捕获包裹解码操作，防止单次错误直接终止程序
• 修正waitKey参数（原代码q未定义，需改为ord('q')）
• 添加资源释放逻辑，程序退出时正确回收摄像头和窗口资源

修改后的完整代码 #

import cv2

# 初始化摄像头和检测器（检测器移到循环外）
cap = cv2.VideoCapture(0)
cap.set(3, 640)
cap.set(4, 480)
qr_detector = cv2.QRCodeDetector()

while True:
    success, image = cap.read()
    # 跳过读取失败的帧
    if not success:
        print("摄像头读取失败，跳过当前帧")
        continue

    try:
        # 尝试解码弯曲二维码
        data, bbox, rectified_image = qr_detector.detectAndDecodeCurved(image)
        if data:
            print(f"识别到内容：{data}")
    except cv2.error as e:
        # 捕获OpenCV异常，打印错误但不终止程序
        print(f"解码异常：{e}")
        continue

    cv2.imshow('二维码识别', image)
    # 按q键退出循环
    if cv2.waitKey(1) & 0xFF == ord('q'):
        break

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

额外优化建议 #

如果错误频繁出现，可以在解码前对图像做预处理，提升检测稳定性：

gray = cv2.cvtColor(image, cv2.COLOR_BGR2GRAY)
blurred = cv2.GaussianBlur(gray, (5,5), 0)
# 用预处理后的图像解码
data, bbox, rectified_image = qr_detector.detectAndDecodeCurved(blurred)

另外可以升级OpenCV到4.6.0及以上版本，官方可能修复了detectAndDecodeCurved的部分已知bug

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