在使用PyQt5进行多线程开发时，许多初学者会遇到一个常见的问题：程序在运行时没有任何明显的错误信息，但却在终端中报出QThread: Destroyed while thread is still running的警告。而在PyCharm等IDE中，只会看到Process finished with exit code -1073740791 (0xC0000409)，让人摸不着头脑。

本文将详细解释这个问题的原因，并提供解决方案和代码示例。

问题描述

在PyQt5应用程序中，我们希望使用QThread来处理耗时任务，以避免阻塞主线程（GUI线程）。但是，当我们在代码中如下创建线程时：

def start_thread(self):thread = MyThread()thread.start()

运行程序，在PyCharm中可能只会看到：

Process finished with exit code -1073740791 (0xC0000409)

而在终端中运行，则会报错：

QThread: Destroyed while thread is still running

这导致程序意外退出，没有任何异常捕获的信息，给调试带来了困难。

原因分析

这个问题的根本原因是线程对象在线程运行期间被垃圾回收机制（GC）回收了。在Python中，如果一个对象没有任何引用，它就会被垃圾回收。当我们在方法中创建线程对象但没有保存引用时，线程对象会在方法结束后被回收，而此时线程可能还在运行，导致了QThread: Destroyed while thread is still running的错误。

由于线程对象被销毁，线程仍在运行，Qt检测到这种不一致性，就会报出上述错误，并导致程序崩溃。

解决方案

为了防止线程对象在运行期间被垃圾回收，我们需要确保线程对象有一个持久的引用。最简单的方法是将线程对象保存为类的成员变量（实例属性）。

代码示例

下面是具体的代码示例，展示如何正确地使用QThread，以及如何修改代码以解决该问题。

错误示例

首先，看看错误的代码示例：

from PyQt5.QtCore import QThreadclass MyWindow(QMainWindow):def __init__(self):super().__init__()# ... 初始化界面 ...def start_thread(self):thread = MyThread()thread.start()# thread变量在方法结束后被回收

在这个例子中，thread是一个局部变量，在start_thread方法结束后就没有引用了，线程对象可能会被垃圾回收。

正确示例

修改后的代码，将线程对象保存为实例属性：

from PyQt5.QtCore import QThreadclass MyWindow(QMainWindow):def __init__(self):super().__init__()# ... 初始化界面 ...self.thread = None  # 在__init__中初始化def start_thread(self):self.thread = MyThread()self.thread.start()

这样，self.thread在整个类的生命周期中都有引用，垃圾回收机制不会在线程运行期间销毁线程对象。

完整代码示例

下面是一个完整的示例，演示如何在PyQt5中正确地使用线程，并解决上述问题。

主窗口类

import sys
from PyQt5.QtWidgets import QApplication, QMainWindow, QPushButton, QVBoxLayout, QWidget, QTextEdit, QProgressBar
from PyQt5.QtCore import QThread, pyqtSignal
import timeclass MyWindow(QMainWindow):def __init__(self):super().__init__()self.setWindowTitle("PyQt5 多线程示例")self.resize(400, 300)# 初始化线程为Noneself.thread = None# 创建按钮和文本框self.button = QPushButton("开始线程")self.button.clicked.connect(self.start_thread)self.text_edit = QTextEdit()self.progress_bar = QProgressBar()self.progress_bar.setRange(0, 100)# 布局layout = QVBoxLayout()layout.addWidget(self.button)layout.addWidget(self.text_edit)layout.addWidget(self.progress_bar)container = QWidget()container.setLayout(layout)self.setCentralWidget(container)def start_thread(self):if self.thread is None:self.thread = WorkerThread()self.thread.progress_updated.connect(self.update_progress)self.thread.log_message.connect(self.update_log)self.thread.finished.connect(self.thread_finished)self.thread.start()def update_progress(self, value):self.progress_bar.setValue(value)def update_log(self, message):self.text_edit.append(message)def thread_finished(self):self.text_edit.append("线程已完成")self.thread = None  # 线程完成后，清理线程对象if __name__ == "__main__":app = QApplication(sys.argv)window = MyWindow()window.show()sys.exit(app.exec_())

线程类

from PyQt5.QtCore import QThread, pyqtSignalclass WorkerThread(QThread):progress_updated = pyqtSignal(int)log_message = pyqtSignal(str)def run(self):for i in range(1, 101):time.sleep(0.1)  # 模拟耗时任务self.progress_updated.emit(i)self.log_message.emit(f"处理进度：{i}%")

运行结果

运行程序，点击“开始线程”按钮，程序不会崩溃，进度条和日志会正常更新。

总结

• 问题原因：线程对象在运行期间被垃圾回收，导致QThread: Destroyed while thread is still running错误。
• 解决方案：将线程对象保存为类的成员变量，确保在线程运行期间，线程对象不会被销毁。
• 注意事项：在多线程编程中，要特别注意对象的生命周期和垃圾回收机制，避免类似的问题。

附：为什么在PyCharm中错误信息不同？

在PyCharm中运行程序时，可能只会看到：

Process finished with exit code -1073740791 (0xC0000409)

这个退出代码0xC0000409表示程序由于堆栈缓冲区溢出而被操作系统强制终止。在Windows系统中，这是STATUS_STACK_BUFFER_OVERRUN的错误代码。

而在终端中运行时，会看到更详细的错误信息：

QThread: Destroyed while thread is still running

这是因为在不同的运行环境下，错误信息的输出方式可能不同。在PyCharm中，某些错误信息可能被IDE捕获或过滤，导致无法直接看到。在终端中运行时，错误信息会直接输出到控制台，因此更容易发现问题的根源。

参考资料

• PyQt5官方文档：线程和并发
• Stack Overflow：QThread: Destroyed while thread is still running

---

希望本文能帮助到在PyQt5多线程开发中遇到类似问题的朋友。如果你有任何疑问或更好的解决方案，欢迎在评论区讨论。