pytest-qt启动qapplication崩溃的常见触发点包括：ci环境未设qt_qpa_platform=offscreen、多处重复创建qapplication、混用pyside6与pyqt5导致元对象冲突，以及第三方库（如matplotlib）提前初始化qapplication；必须通过qtbot.qapp访问实例，禁用自定义fixture中新建qapplication。
pytest-qt 启动 QApplication 时崩溃：常见触发点
崩溃通常发生在测试首次尝试创建 QApplication 实例时，尤其是当系统缺少 GUI 环境（如 CI 服务器）或已有 QApplication 正在运行。pytest-qt 默认会自动管理 QApplication 生命周期，但若测试进程里已存在 QApplication（比如被其他模块提前初始化），再调用 QApplication(sys.argv) 就会直接 abort —— 这不是异常，是 Qt 的硬性限制。
- CI 环境未启用 headless 模式（如没设
QT_QPA_PLATFORM=offscreen） - 多个测试文件/fixture 中重复调用
QApplication构造函数 - 测试前手动导入了 PyQt5/PySide2 并意外触发了
QApplication.instance()非空判断失败
必须设置的 headless 环境变量
即使你没显式启动窗口，Qt 仍可能尝试连接本地 X11/Wayland。不设平台后端，pytest-qt 在无显示环境里会卡住或崩溃。这不是可选配置，是强制前提。
- Linux CI：启动 pytest 前执行
export QT_QPA_PLATFORM=offscreen - macOS：用
export QT_QPA_PLATFORM=offscreen（注意：minimal在某些 PySide2 版本中不可靠） - Windows：一般不需要，但若用 WSL 或远程桌面，仍建议加该变量
- Pytest 命令行中也可传入：
QT_QPA_PLATFORM=offscreen pytest tests/
避免 QApplication 冲突的 fixture 写法
pytest-qt 提供了 qtbot fixture，它内部确保 QApplication 单例且只初始化一次。但如果你自己写了 @pytest.fixture 并在里面 new QApplication，就会破坏这个机制。
- 绝对不要在自定义 fixture 中写
QApplication([])或QApplication(sys.argv) - 需要访问 QApplication 实例？用
qtbot.qapp，它是 pytest-qt 管理的唯一合法实例 - 如果必须重置 QApplication（极少数场景），应调用
qtbot.addCleanup(qtbot.qapp.quit)而非手动 quit + 新建 - 检查是否引入了依赖 Qt 的第三方库（如 matplotlib、pyvista），它们可能偷偷初始化 QApplication
PySide6 与 PyQt5 混用导致的崩溃
同一进程里混载 PySide6 和 PyQt5（哪怕只是 import）会导致 Qt 元对象系统冲突，pytest-qt 启动时直接 segfault。这种崩溃没有 Python traceback，只有 core dump 或 “Aborted” 输出。
- 运行
python -c "import PyQt5; import PySide6"就能复现 —— 不要这么做 - 检查
pip list是否同时存在PyQt5和PySide6（或PySide2） - pytest-qt 官方只保证与单一绑定兼容；推荐统一用
PySide6（LGPL，无商业授权顾虑） - 若项目必须用 PyQt5，请卸载所有 PySide* 包，并确认虚拟环境干净
实际调试时，先跑 QT_DEBUG_PLUGINS=1 pytest --capture=no test_gui.py 看 Qt 插件加载日志，崩溃前往往有 “Cannot load library” 或 “Plugin path not found” 提示 —— 这些不是警告，是崩溃前兆。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
