PyQt5中OpenCV摄像头采集线程停止后无法恢复问题求解

开发计算机视觉项目配套的PyQt GUI界面时，需要实现按钮控制摄像头采集流的停止与恢复功能。目前停止逻辑运行正常，但点击恢复按钮后摄像头虽被启动，无法正常输出画面，原始实现代码如下：

from PyQt5 import uic
from PyQt5 import QtCore, QtWidgets, QtGui
import cv2
import sys

class opencv_feed(QtWidgets.QMainWindow):
    def __init__(self):
        QtWidgets.QMainWindow.__init__(self)
        self.ui = uic.loadUi('../designs/design5_flexible_opencv_window2.ui', self)
        self.resize(900,600)

        self.worker1 = worker1()
        self.worker1.start()
        self.worker1.ImgUpdate.connect(self.ImageUpdateSlot)
        self.but_stop.clicked.connect(self.cancel_feed)
        self.but_resume.clicked.connect(self.resume_feed)
        
   
    def ImageUpdateSlot(self, Image):
        self.label.setPixmap(QtGui.QPixmap.fromImage(Image))
        
    def cancel_feed(self):
        self.worker1.stop()
    
    def resume_feed(self):
        self.__init__()

class worker1(QtCore.QThread):
    ImgUpdate = QtCore.pyqtSignal(QtGui.QImage)
    
    @QtCore.pyqtSlot()
    def run(self):
        self.ThreadActive = True
        self.feed = cv2.VideoCapture(0)
        while self.ThreadActive:
            self.ret, self.frm = self.feed.read()
            if self.ret:
                self.img = cv2.cvtColor(self.frm, cv2.COLOR_BGR2RGB)
                self.img = cv2.flip(self.img,1)
                self.qtformat_conv_img = QtGui.QImage(self.img.data, self.img.shape[1], self.img.shape[0], QtGui.QImage.Format_RGB888)
                self.pic = self.qtformat_conv_img.scaled(self.img.shape[1],self.img.shape[0],QtCore.Qt.KeepAspectRatio)
                self.ImgUpdate.emit(self.pic)
    def stop(self):
        self.ThreadActive = False
        self.feed.release()
        self.quit()
        
if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    wind = opencv_feed()
    wind.show()
    sys.exit(app.exec_())

• 恢复逻辑严重违规：resume_feed方法直接调用self.__init__()重复执行窗口类初始化流程，会重复加载UI、创建新的worker线程实例，原有已显示的窗口、已停止的旧线程实例不会被销毁，新线程输出的画面会发送到新初始化的隐藏label控件上，用户看到的旧窗口自然收不到画面，同时会造成内存泄漏、信号重复绑定问题。
• 线程生命周期设计错误：QThread实例调用quit()退出事件循环、run方法执行完毕后，线程生命周期就已结束，无法直接重新启动。原有stop方法直接调用self.quit()销毁线程，没有提供可复用的暂停/恢复逻辑。
• 摄像头资源初始化逻辑位置错误：摄像头打开操作只在run()方法最开始执行一次，stop方法释放摄像头资源后，没有逻辑重新打开摄像头，就算线程重新运行也读不到帧。
• 资源释放流程不严谨：stop方法调用线程退出、释放摄像头时没有等待线程完全终止，容易出现摄像头端口被残留进程占用，导致重启读流失败。

1. 删除resume_feed中调用self.__init__()的错误逻辑，窗口初始化只在程序启动时执行一次。
2. 调整worker线程逻辑：stop方法不退出线程，仅暂停读帧循环、释放摄像头；新增resume方法重新打开摄像头、恢复读帧循环，避免反复创建销毁线程的开销。
3. 增加线程退出等待逻辑，确保摄像头资源完全释放后再执行后续操作。

修复后完整代码：

from PyQt5 import uic
from PyQt5 import QtCore, QtWidgets, QtGui
import cv2
import sys

class opencv_feed(QtWidgets.QMainWindow):
    def __init__(self):
        QtWidgets.QMainWindow.__init__(self)
        self.ui = uic.loadUi('../designs/design5_flexible_opencv_window2.ui', self)
        self.resize(900,600)

        self.worker1 = worker1()
        self.worker1.start()
        self.worker1.ImgUpdate.connect(self.ImageUpdateSlot)
        self.but_stop.clicked.connect(self.cancel_feed)
        self.but_resume.clicked.connect(self.resume_feed)
        
   
    def ImageUpdateSlot(self, Image):
        self.label.setPixmap(QtGui.QPixmap.fromImage(Image))
        
    def cancel_feed(self):
        self.worker1.stop()
    
    def resume_feed(self):
        # 仅调用worker的恢复方法，不重新初始化整个窗口
        self.worker1.resume()
    
    def closeEvent(self, event):
        # 窗口关闭时正确销毁线程、释放资源
        self.worker1.stop()
        self.worker1.wait()
        event.accept()

class worker1(QtCore.QThread):
    ImgUpdate = QtCore.pyqtSignal(QtGui.QImage)
    
    def __init__(self):
        super().__init__()
        self.ThreadActive = False
        self.feed = None
    
    @QtCore.pyqtSlot()
    def run(self):
        self.ThreadActive = True
        self.feed = cv2.VideoCapture(0)
        while self.ThreadActive:
            ret, frm = self.feed.read()
            if ret:
                img = cv2.cvtColor(frm, cv2.COLOR_BGR2RGB)
                img = cv2.flip(img,1)
                qtformat_conv_img = QtGui.QImage(img.data, img.shape[1], img.shape[0], QtGui.QImage.Format_RGB888)
                pic = qtformat_conv_img.scaled(img.shape[1],img.shape[0],QtCore.Qt.KeepAspectRatio)
                self.ImgUpdate.emit(pic)
            else:
                break

    def stop(self):
        self.ThreadActive = False
        if self.feed and self.feed.isOpened():
            self.feed.release()
        # 不调用quit()退出线程，保持线程事件循环运行，方便后续恢复
        self.wait(1000) # 等待线程当前帧处理完成，避免资源冲突
    
    def resume(self):
        # 线程未运行则启动，已运行则重新打开摄像头恢复读帧
        if not self.isRunning():
            self.start()
        else:
            self.ThreadActive = True
            if not self.feed or not self.feed.isOpened():
                self.feed = cv2.VideoCapture(0)
        
if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    wind = opencv_feed()
    wind.show()
    sys.exit(app.exec_())

注意：运行代码前请确保UI文件路径正确，摄像头设备未被其他程序占用。

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