PyQt6模态窗口关闭后主窗口层级被外部应用覆盖原因排查

问题现象 #

运行示例代码后，打开MainWindow中的DialogA，再从DialogA打开DialogB。通过按钮关闭DialogB时，MainWindow会被挤到后台，原本在MainWindow后方的外部窗口（如PyCharm）会前置到前台。仅当使用deleteLater()销毁窗口时出现该问题，改用close()则可恢复正常。

最小复现代码 #

from PyQt6.QtCore import pyqtSignal, Qt
from PyQt6.QtWidgets import QApplication, QDialog, QLabel, QPushButton, QVBoxLayout


class DialogA(QDialog):
    def __init__(self, parent):
        super().__init__(parent)
        self.setWindowModality(Qt.WindowModality.ApplicationModal)
        self.setModal(True)
        self.setWindowTitle("Dialog A")
        self.setLayout(QVBoxLayout())
        self.layout().addWidget(QLabel("This is Dialog A"))

        open_dialog_b_button = QPushButton("Open Dialog B")
        open_dialog_b_button.clicked.connect(self.open_dialog_b)

        self.layout().addWidget(open_dialog_b_button)

    def open_dialog_b(self):
        dialog_b = DialogB(self)
        dialog_b.closed.connect(self.close_dialog_a)
        dialog_b.exec()

    def close_dialog_a(self):
        self.deleteLater()


class DialogB(QDialog):
    closed = pyqtSignal()

    def __init__(self, parent):
        super().__init__(parent)
        self.setWindowModality(Qt.WindowModality.ApplicationModal)
        self.setModal(True)
        self.setWindowTitle("Dialog B")
        self.setLayout(QVBoxLayout())
        self.layout().addWidget(QLabel("This is Dialog B"))
        close_button = QPushButton("Close")
        close_button.clicked.connect(self.on_close_button_clicked)
        self.layout().addWidget(close_button)

    def on_close_button_clicked(self):
        self.closed.emit()
        self.deleteLater()

    def closeEvent(self, event):
        self.closed.emit()
        super().closeEvent(event)


if __name__ == "__main__":
    app = QApplication([])
    main_window = QDialog()
    main_window.setWindowTitle("Main Window")
    main_window.setLayout(QVBoxLayout())

    open_dialog_a_button = QPushButton("Open Dialog A")
    open_dialog_a_button.clicked.connect(lambda: DialogA(main_window).show())

    main_window.layout().addWidget(open_dialog_a_button)
    main_window.show()
    app.exec()

原因分析 #

1. 模态窗口的焦点与Z-Index管理逻辑
   Qt的ApplicationModal模态对话框会接管整个应用的焦点，阻塞所有非模态窗口的交互。当DialogB以exec()方式打开时，它会阻塞DialogA的事件循环，直到自身关闭。

2. deleteLater()的异步特性
   deleteLater()是将窗口销毁操作放入Qt事件队列中延迟执行，而非立即销毁。当点击DialogB的关闭按钮时，closed信号触发DialogA的deleteLater()，此时DialogA和DialogB都只是被标记为待销毁，并未立即从窗口系统中移除。
   操作系统的窗口管理器在处理模态窗口关闭时，会尝试将焦点归还给应用内的下一个活跃窗口，但此时DialogA处于“待销毁”的过渡状态，MainWindow也未被主动激活，窗口管理器无法找到明确的目标窗口，就会将焦点切换到之前最后聚焦的外部窗口，导致MainWindow被挤到后台。

3. close()的同步处理逻辑
   改用close()时，窗口会被立即关闭，Qt的模态窗口管理系统会同步处理焦点回退：DialogB关闭后焦点回到DialogA，DialogA关闭后焦点最终归还给MainWindow，窗口管理器能明确识别应用内的顶层窗口，不会出现Z-Index异常。

总结 #

问题核心在于deleteLater()的异步销毁打破了Qt模态窗口的焦点回退链，导致窗口管理器无法正确识别应用内的活跃窗口。如果必须使用deleteLater()，可以在销毁DialogA前主动调用main_window.activateWindow()或main_window.raise()来强制激活MainWindow，确保其Z-Index层级正确。

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