嵌入式PySide/PyQt4 Python代码关闭时出现内存泄漏问题

我之前在做类似的C++ Qt4嵌入Python解释器加载PySide脚本的项目时，也踩过这个内存泄漏的坑，结合我的实际排查经验，给你几个针对性的解决方向：

1. 严格把控Python解释器的初始化与清理顺序 #

这是最容易出错的核心点，一定要遵循这个流程：

• Py_Initialize()要在Qt的QApplication初始化之后调用
• Py_Finalize()必须在Qt事件循环完全结束、所有Qt对象进入销毁流程之后执行
• 调用Py_Finalize()前必须通过PyGILState_Ensure()获取GIL锁，避免线程安全问题导致的引用计数混乱

2. 手动清理PySide对象的引用计数 #

你怀疑的引用计数问题确实是高发区，可以这么排查和处理：

• 对Python脚本中创建的关键PySide对象（比如QWidget、自定义QObject子类），在退出前手动调用Py_DECREF()减少引用计数
• 检查是否有Qt信号槽绑定了Python对象，这类绑定会额外增加引用计数，需要在退出前手动断开连接（比如调用QObject::disconnect()）
• 可以用Py_REFCNT(obj)打印对象的实时引用计数，定位哪些对象在退出时引用计数未归零

3. 避免Qt与Python事件循环的冲突 #

如果你的C++程序已经运行了Qt的事件循环，Python脚本里不要再重复初始化QApplication：

• 让Python脚本复用C++端的qApp实例，比如在脚本开头添加：

  from PySide.QtCore import qApp
  

• 在退出前，先调用qApp.exit()终止Python端可能残留的事件处理，再调用qApp->processEvents()处理所有待销毁的Qt对象

4. 针对性分析Address Sanitizer的泄漏日志 #

把ASAN报告的泄漏详情拆解开，精准定位问题：

• 如果泄漏的是Python堆内存，重点排查引用计数未归零的对象
• 如果泄漏的是Qt对象，大概率是PySide包装的Qt对象没有被Qt的对象树正确回收，需要手动触发销毁（比如调用deleteLater()）

简化的清理代码示例 #

这里给你一段C++端退出时的清理逻辑，亲测能解决大部分PySide相关的内存泄漏：

// 先终止Qt事件循环并处理剩余事件
qApp->quit();
qApp->processEvents(QEventLoop::AllEvents, 2000);

// 获取GIL锁，安全操作Python对象
PyGILState_STATE gstate = PyGILState_Ensure();

// 清理PySide的qApp引用
PyObject* pyside_core = PyImport_ImportModule("PySide.QtCore");
if (pyside_core) {
    PyObject* qApp_obj = PyObject_GetAttrString(pyside_core, "qApp");
    if (qApp_obj && qApp_obj != Py_None) {
        PyObject_CallMethod(qApp_obj, "exit", NULL);
        Py_DECREF(qApp_obj);
    }
    Py_DECREF(pyside_core);
}

// 强制清理Python解释器状态
Py_FinalizeEx();
PyGILState_Release(gstate);

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