PyQt/PySide6点击按钮显示耗时报错：跨线程无法停止定时器

我想要实现以下简单功能：

• 一个按钮，点击后启动一项耗时2秒的任务
• 一个标签，显示任务已运行的时长

运行代码后功能正常，但控制台输出错误：

QObject::killTimer: Timers cannot be stopped from another thread

作为PyQt新手，我不知道如何修复该错误，同时有以下疑问：

• 是否应该使用threading.Thread，还是改用QThread，或是采用其他代码结构？
• 使用线程避免GUI阻塞是否是常规做法，还是我在重复造轮子？

原代码 #

from PySide6.QtWidgets import (
    QApplication, QWidget, QVBoxLayout, QPushButton, QLabel
)
from PySide6.QtCore import QTime, QTimer
import threading
import time


class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.resize(200, 100)
        self.button = QPushButton('Do work', self)
        self.button.clicked.connect(self.run_work_thread)
        self.timer_label = QLabel('', self)  # hide label at the start (but save its space)
        layout = QVBoxLayout(self)
        layout.addWidget(self.button)
        layout.addWidget(self.timer_label)
        self.setLayout(layout)

    def run_work_thread(self):
        """Do work in a separate thread, not to block the GUI"""
        self.button.setEnabled(False)
        thread = threading.Thread(target=self.do_work)
        thread.start()

        self.start_time = QTime(0, 0, 0)
        self.timer = QTimer(self)
        self.timer_label.setText('Doing work for: 0 s')
        self.timer.timeout.connect(self.update_timer)
        self.timer.start(1000)  # update every 1 sec

    def do_work(self):
        time.sleep(2)  # Simulate work
        self.timer.stop()
        self.timer_label.setText('')  # clear the timer label
        self.button.setEnabled(True)

    def update_timer(self):
        """Update the timer, and its label with the elapsed time"""
        self.start_time = self.start_time.addMSecs(1000)
        self.timer_label.setText(f'Doing work for: {self.start_time.toString("s")} s')


if __name__ == '__main__':
    app = QApplication([])
    window = MyWindow()
    window.show()
    app.exec()

错误原因 #

控制台的错误是因为Qt的GUI对象（包括QTimer、QLabel、QPushButton）只能在主线程（GUI线程）中操作，你在threading.Thread的子线程里调用self.timer.stop()、修改timer_label文本、启用按钮，这些都是跨线程操作Qt对象，违反了Qt的线程规则。

修复方案 #

有两种常用的修复方式，核心都是让GUI操作回到主线程执行：

方式1：使用QMetaObject.invokeMethod（兼容threading.Thread） #

修改do_work方法，通过Qt的元对象调用机制，把GUI相关操作派发到主线程：

from PySide6.QtCore import QMetaObject, Qt

# ... 保留原代码其他部分 ...

def do_work(self):
    time.sleep(2)  # Simulate work
    # 用invokeMethod将GUI操作派发到主线程
    QMetaObject.invokeMethod(self.timer, "stop", Qt.QueuedConnection)
    QMetaObject.invokeMethod(self.timer_label, "setText", Qt.QueuedConnection,
                            Qt.arg(""))
    QMetaObject.invokeMethod(self.button, "setEnabled", Qt.QueuedConnection,
                            Qt.arg(True))

方式2：改用QThread+信号槽（更符合Qt的设计风格） #

Qt的QThread天生支持信号槽机制，子线程完成任务后发送信号，主线程接收信号后处理GUI操作：

from PySide6.QtCore import QTime, QTimer, QThread, Signal

# 定义工作线程类
class WorkThread(QThread):
    work_finished = Signal()  # 任务完成信号

    def run(self):
        time.sleep(2)  # 模拟耗时任务
        self.work_finished.emit()  # 发送完成信号

class MyWindow(QWidget):
    def __init__(self):
        super().__init__()
        self.resize(200, 100)
        self.button = QPushButton('Do work', self)
        self.button.clicked.connect(self.run_work_thread)
        self.timer_label = QLabel('', self)
        layout = QVBoxLayout(self)
        layout.addWidget(self.button)
        layout.addWidget(self.timer_label)
        self.setLayout(layout)
        self.work_thread = WorkThread()
        self.work_thread.work_finished.connect(self.on_work_finished)

    def run_work_thread(self):
        self.button.setEnabled(False)
        self.work_thread.start()

        self.start_time = QTime(0, 0, 0)
        self.timer = QTimer(self)
        self.timer_label.setText('Doing work for: 0 s')
        self.timer.timeout.connect(self.update_timer)
        self.timer.start(1000)

    def on_work_finished(self):
        # 主线程中处理GUI操作
        self.timer.stop()
        self.timer_label.setText('')
        self.button.setEnabled(True)
        self.work_thread.quit()
        self.work_thread.wait()

    def update_timer(self):
        self.start_time = self.start_time.addMSecs(1000)
        self.timer_label.setText(f'Doing work for: {self.start_time.toString("s")} s')

# ... 主函数部分不变 ...

疑问解答 #

1. 线程选择：threading.Thread可以用，但需要手动处理跨线程GUI操作；QThread更贴合Qt的生态，通过信号槽能更安全、简洁地处理线程间通信，推荐Qt项目优先用QThread。
2. 线程避免GUI阻塞是常规做法：Qt的GUI事件循环在主线程，耗时任务必须放到子线程，否则会导致GUI冻结无响应，这是Qt开发的标准做法，不是重复造轮子。

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