PyQt5 QMessageBox定时关闭失效：鼠标事件无法重置定时器

核心原因 #

你遇到的问题本质是鼠标移动事件没有被自定义的TimerBasedMessageBox类正确捕获。QMessageBox内部包含多个子控件（如文本标签、按钮等），当鼠标在这些子控件上移动时，事件会被子控件优先处理，不会传递到父类的mouseMoveEvent方法，导致你调用的self.timer.start()根本没被触发，定时器自然不会重置。

解决方法 #

给QMessageBox及其所有子部件安装事件过滤器，统一监听所有鼠标相关事件，这样无论鼠标在哪个子控件上活动，都能触发定时器重置。以下是完整的实现代码：

from PyQt5.QtWidgets import QMessageBox, QWidget
from PyQt5.QtCore import QTimer, QEvent

class TimerBasedMessageBox(QMessageBox):
    def __init__(self, timeout_seconds=5, parent=None):
        super().__init__(parent)
        self.timeout_ms = timeout_seconds * 1000
        
        # 初始化定时器
        self.timer = QTimer(self)
        self.timer.setSingleShot(True)  # 单次触发，避免重复关闭
        self.timer.timeout.connect(self.close)
        self.timer.start(self.timeout_ms)
        
        # 给自身和所有子部件安装事件过滤器
        self.installEventFilter(self)
        for child in self.findChildren(QWidget):
            child.installEventFilter(self)

    def eventFilter(self, obj, event):
        # 捕获所有鼠标活动事件：移动、点击、进入控件等
        event_types = (QEvent.MouseMove, QEvent.MouseButtonPress, 
                       QEvent.MouseButtonRelease, QEvent.Enter)
        if event.type() in event_types:
            # 重置定时器：先停止再启动，确保计时从头开始
            self.timer.stop()
            self.timer.start(self.timeout_ms)
        
        # 记得返回父类的处理结果，不影响其他事件传递
        return super().eventFilter(obj, event)

额外注意点 #

• 用setSingleShot(True)将定时器设为单次触发，避免定时器多次触发导致意外关闭。
• 除了MouseMove，还可以监听MouseButtonPress、Enter等事件，覆盖更多用户交互场景。
• 确保初始化定时器时传入了正确的超时毫秒数（比如5秒就是5000），如果没传参数，QTimer默认超时时间为0，会立即触发关闭。

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