如何在QTimer的timeout事件中正确停止定时器且无报错？

使用QTimer定时执行任务时，若任务抛出异常，需要停止QTimer但不销毁它以便后续重启。但在timeout事件内停止定时器时，无法立即停止，短时间内会多次触发，还会出现Timers cannot be stopped from another thread错误。请问正确的无报错立即让定时器停止自身的方法是什么？

演示代码 #

import sys
from PyQt5.QtCore import *
from PyQt5.QtWidgets import *


class MyWorker(QObject):
    def __init__(self):
        super().__init__()
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.tick)

    def begin(self):
        self.timer.start(1)

    def tick(self):
        try:
            print("error raised")
            raise Exception()
        except:
            print("error caught, stopping")
            self.timer.stop()


class MainWindow(QMainWindow):
    startSignal = pyqtSignal()

    def __init__(self):
        super().__init__()
        self.myThread = QThread()
        self.myWorker = MyWorker()
        self.myWorker.moveToThread(self.myThread)
        self.startSignal.connect(self.myWorker.begin)
        self.myThread.start()
        self.startSignal.emit()


if __name__ == '__main__':
    app = QApplication(sys.argv)
    window = MainWindow()
    sys.exit(app.exec())

错误输出 #

error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
error raised
error caught, stopping
QObject::killTimer: Timers cannot be stopped from another thread

解决方案 #

问题根源 #

1. 事件堆积：设置的1ms定时器间隔远小于tick函数的执行耗时，Qt事件循环会把未处理的timeout事件排队，调用stop后队列里的事件仍会继续触发。
2. 线程安全问题：若tick操作涉及跨线程调用，或者定时器的线程归属处理不当，会导致在非定时器所在线程执行stop，触发线程错误。

正确实现方式 #

方法1：先断开信号再停止定时器

在停止前断开timeout与tick的连接，避免队列中的事件继续触发：

def tick(self):
    try:
        print("error raised")
        raise Exception()
    except:
        print("error caught, stopping")
        self.timer.timeout.disconnect(self.tick)  # 先断开信号
        self.timer.stop()

后续重启时重新连接信号并启动：

def restart(self):
    self.timer.timeout.connect(self.tick)
    self.timer.start(1)

方法2：用线程安全信号触发停止

通过自定义信号让定时器所在线程处理停止操作，规避跨线程调用问题：

class MyWorker(QObject):
    stopTimerSignal = pyqtSignal()  # 自定义停止信号

    def __init__(self):
        super().__init__()
        self.timer = QTimer(self)
        self.timer.timeout.connect(self.tick)
        self.stopTimerSignal.connect(self.timer.stop)  # 信号绑定停止操作

    def tick(self):
        try:
            print("error raised")
            raise Exception()
        except:
            print("error caught, stopping")
            self.stopTimerSignal.emit()  # 发送信号让线程内处理停止

方法3：设置单次触发模式（按需选择）

如果任务不需要连续触发，可将定时器设为单次模式，无异常时手动重启，避免事件堆积：

def __init__(self):
    super().__init__()
    self.timer = QTimer(self)
    self.timer.setSingleShot(True)  # 设置单次触发
    self.timer.timeout.connect(self.tick)

def begin(self):
    self.timer.start(1)

def tick(self):
    try:
        print("error raised")
        raise Exception()
    except:
        print("error caught, stopping")
    else:
        self.timer.start(1)  # 无异常则重启

额外建议 #

• 避免设置过小的定时器间隔（如1ms），除非操作能在极短时间内完成，否则必然导致事件堆积。
• 所有对QTimer的start/stop操作，都应在定时器所在线程执行，Qt信号槽机制可天然保证线程安全。

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