PyQt6 pytest测试套件报错 无法读取null的testsuites属性

问题现象 #

使用pytest为自研PyQt6桌面应用主窗口类编写测试套件时，测试进程直接终止，既不返回用例成功结果也不返回失败结果，VS Code pytest集成插件抛出如下错误：

TypeError: Cannot read properties of null (reading 'testsuites')

被测MainWindow类在非测试环境下可正常渲染运行，无运行时异常。

相关代码 #

MainWindow类实现 #

import logging
from PyQt6.QtCore import Qt
from PyQt6.QtGui import QIcon, QAction
from PyQt6.QtWidgets import QMainWindow, QStackedWidget, QToolButton, QToolBar, QWidget, QApplication
import sys


class MainWindow(QMainWindow):
    """
    Main window class - this will house the main window
    for the desktop application.
    """

    def __init__(self) -> None:
        # setup basic page components
        super().__init__()
        self.setWindowTitle("Demo App")
        self.setWindowState(Qt.WindowState.WindowMaximized)

        # call page setup here
        self.setup_application()

    @property
    def logger(self) -> logging.Logger:
        return logging.getLogger(f"{__name__}.{self.__class__.__name__}")

    def setup_application(self) -> None:
        self.logger.debug("Starting MainWindow setup")
        # setup stack of widgets (different views)
        self.setup_stack()
        # setup toolbar for view navigation
        self.setup_toolbar()

    def setup_stack(self) -> None:
        # all views to be added into application
        self.first = QWidget()
        self.second = QWidget()
        self.third = QWidget()
        self.fourth = QWidget()

        # add widgets to stack
        self.stack = QStackedWidget(self)
        self.stack.addWidget(self.first)
        self.stack.addWidget(self.second)
        self.stack.addWidget(self.third)
        self.stack.addWidget(self.fourth)

        # set indexes of views in stack
        self.FIRST_INDEX = 0
        self.SECOND_INDEX = 1
        self.THIRD_INDEX = 2
        self.FOURTH_INDEX = 3

        # finally, set central widget for application
        self.setCentralWidget(self.stack)

    def setup_toolbar(self) -> None:
        # setup actions for views' toolbuttons
        self.first_action = QAction("Page 1", self)
        self.second_action = QAction("Page 2", self)
        self.third_action = QAction("Page 3", self)
        self.fourth_action = QAction("Page 4", self)
        self.first_action.triggered.connect(
            lambda: self.change_window(self.FIRST_INDEX)
        )
        self.second_action.triggered.connect(lambda: self.change_window(self.SECOND_INDEX))
        self.third_action.triggered.connect(
            lambda: self.change_window(self.THIRD_INDEX)
        )
        self.fourth_action.triggered.connect(
            lambda: self.change_window(self.FOURTH_INDEX)
        )

        # setup buttons for toolbar
        self.first_button = QToolButton()
        self.first_button.setDefaultAction(self.first_action)
        self.second_button = QToolButton()
        self.second_button.setDefaultAction(self.second_action)
        self.third_button = QToolButton()
        self.third_button.setDefaultAction(self.third_action)
        self.fourth_button = QToolButton()
        self.fourth_button.setDefaultAction(self.fourth_action)

        # finally, setup toolbar for top of screen
        self.toolbar = QToolBar()
        self.toolbar.addWidget(self.first_button)
        self.toolbar.addWidget(self.second_button)
        self.toolbar.addWidget(self.third_button)
        self.toolbar.addWidget(self.fourth_button)
        self.toolbar.setMovable(False)
        self.addToolBar(self.toolbar)

    def change_window(self, index: int) -> None:
        # TODO: add bold text/button highlighting to make it clear from
        # the toolbar which view you are on
        # set application view to desired view, just doing this for now
        self.stack.setCurrentIndex(index)

常规环境启动代码 #

def main() -> None:
    # TODO: Figure way to get package name dynamically
    app = QApplication(sys.argv)
    window = MainWindow()
    window.show()
    sys.exit(app.exec())


# invoke application
if __name__ == "__main__":
    main()

初始测试代码（test_main_window.py） #

# add imports for any files to be tested in windows
# package imports
import pytest
from pytest_mock import MockerFixture
from pytestqt.plugin import QtBot
import sys

# file imports
from windows.main_window import MainWindow


# tests should start with `test_` and be followed by function name
#    example: test_my_fancy_func()

@pytest.fixture
def mw() -> MainWindow:
    return MainWindow()

class TestMainWindow:
    def test_dummy(self, mw: MainWindow) -> None:
        pass

已尝试无效方案 #

• 在测试文件中手动定义QApplication实例
• 直接引入pytest-qt插件提供的QtBot组件

根因分析 #

1. 你看到的Cannot read properties of null (reading 'testsuites')不是Python侧或pytest抛出的业务错误，是VS Code测试插件的前端JS报错：测试进程异常崩溃后，插件拿不到合法的JUnit格式测试结果，解析结果文件时读到null值才抛出该错误，这个报错完全掩盖了真实的崩溃原因。
2. 真实崩溃原因是自定义的mw fixture没有遵循pytest-qt的运行规则：创建Qt窗口前必须先初始化全局唯一的QApplication实例，直接实例化MainWindow时，Qt底层检测到不存在QApplication实例会直接触发段错误终止进程，和MainWindow本身的业务逻辑无关。
3. 手动创建QApplication实例无效的原因是容易和pytest-qt内部维护的QApplication实例冲突，多实例会直接导致Qt进程崩溃。

修复步骤 #

1. 先脱离VS Code插件验证真实错误：在项目根目录终端直接执行pytest test_main_window.py -v，可以看到Python侧的真实报错，避免被VS Code的JS错误误导。如果是无桌面环境（比如WSL、CI环境）跑测试，先在环境变量里加QT_QPA_PLATFORM=offscreen，避免Qt尝试连接显示服务失败。
2. 修正mw fixture，显式依赖pytest-qt提供的qapp fixture保证QApplication提前初始化，同时用qtbot接管窗口生命周期，测试结束后自动清理Qt对象避免内存泄漏或崩溃，修正后的fixture代码如下：

from PyQt6.QtWidgets import QApplication

@pytest.fixture
def mw(qapp: QApplication, qtbot: QtBot) -> MainWindow:
    # qapp fixture会自动初始化全局唯一的QApplication实例，无需手动创建
    window = MainWindow()
    # 将窗口注册到qtbot，由qtbot负责事件处理和测试后清理
    qtbot.addWidget(window)
    yield window
    # 测试结束后显式销毁窗口
    window.deleteLater()

3. 修正后先在终端跑测试确认通过，再回到VS Code执行测试，插件的JS报错会自动消失。

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