PyQt5中使用QOpenGLWidget时如何正确销毁OpenGL资源

问题场景 #

你的PyQt5 QOpenGLWidget代码可以正常渲染图形，但关闭窗口时会出现资源释放相关报错：

• 最初使用__del__方法释放VAO/VBO/IBO和着色器程序时，报错RuntimeError: wrapped C/C++ object of type QOpenGLVertexArrayObject has been deleted
• 移除__del__后，又出现QOpenGLVertexArrayObject::destroy() failed to restore current context
• 尝试连接上下文的aboutToBeDestroyed信号到自定义清理函数，但函数未被触发

正确解决方案 #

方案1：重写QOpenGLWidget的cleanup()虚函数 #

Qt官方为QOpenGLWidget提供了专门的资源清理入口——cleanup()虚函数。当Widget销毁时，Qt会自动将OpenGL上下文设为当前状态，然后调用该方法，无需手动管理上下文切换。

修改代码，移除原有的__del__方法，添加如下cleanup()实现：

class OpenGLWidget(QOpenGLWidget):
    # 保留__init__、initializeGL、paintGL、resizeGL等原有方法

    def cleanup(self):
        # 释放OpenGL资源
        self.vao.destroy()
        self.vbo.destroy()
        self.ibo.destroy()
        self.program.removeAllShaders()
        
        # 将资源对象置空，协助Python垃圾回收
        self.vao = None
        self.vbo = None
        self.ibo = None
        self.program = None

方案2：重写closeEvent方法 #

若方案1因版本兼容问题不生效，可通过重写窗口关闭事件，手动确保上下文正确后再释放资源：

class OpenGLWidget(QOpenGLWidget):
    # 保留原有方法

    def closeEvent(self, event):
        # 手动将当前上下文设为当前
        self.makeCurrent()
        
        # 释放资源
        self.vao.destroy()
        self.vbo.destroy()
        self.ibo.destroy()
        self.program.removeAllShaders()
        
        # 结束上下文
        self.doneCurrent()
        
        # 调用父类的关闭事件处理
        super().closeEvent(event)

错误原因分析 #

1. __del__方法的问题：Python垃圾回收时机与Qt C++对象的销毁顺序不一致，当__del__执行时，Qt的OpenGL资源对象可能已经被销毁，导致报错。
2. 信号连接失效：在paintGL中连接aboutToBeDestroyed信号的时机过晚，窗口关闭时上下文的销毁流程可能已跳过信号触发环节，导致清理函数未执行。

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