复现scikit-surgerytutorial01时PySide2初始化错误的排查与解决

问题描述 #

我正尝试复现scikit-surgerytutorial01，严格遵循官方文档步骤，创建虚拟环境并安装了requirements.txt和.yml文件指定版本的所有依赖。

创建了overlay.py文件，代码如下：

import sys
from PySide2.QtWidgets import QApplication
from sksurgeryutils.common_overlay_apps import OverlayBaseWidget
class OverlayApp(OverlayBaseWidget):
         def update_view(self):
                   _, image = self.video_source.read()
                   self.vtk_overlay_window.set_video_image(image)
                   self.vtk_overlay_window.Render()
if __name__ == '__main__':
         app = QApplication([])
         video_source = 0
         viewer = OverlayApp(video_source)
         model_dir = '../models'
         viewer.add_vtk_models_from_dir(model_dir)
         viewer.show()
         viewer.start()
         sys.exit(app.exec_())

执行代码时出现错误：

(python_3.7_venv) younes@younes-ThinkPad-X1-Carbon-3rd:~/python_3.7_venv$ python overlay.py
Warning: Ignoring XDG_SESSION_TYPE=wayland on Gnome. Use QT_QPA_PLATFORM=wayland to run on Wayland anyway.
QWidget: Must construct a QApplication before a QWidget
Aborted (core dumped)

错误原因 #

核心原因是**OverlayBaseWidget的父类在模块导入阶段会触发Qt组件的初始化，而此时QApplication实例还未创建**。虽然你在if __name__ == '__main__':代码块里先实例化了QApplication，但模块级别的from sksurgeryutils.common_overlay_apps import OverlayBaseWidget导入操作会先于main代码块执行，导致Qt在没有QApplication的情况下尝试创建QWidget，最终触发报错。

解决方法 #

1. 调整代码执行顺序 #

将QApplication的实例化放在所有Qt相关导入之前，确保所有Qt组件的初始化都在QApplication之后进行。修改后的代码如下：

import sys

# 优先创建QApplication实例
app = QApplication([])

# 再导入Qt相关类和OverlayBaseWidget
from PySide2.QtWidgets import QWidget
from sksurgeryutils.common_overlay_apps import OverlayBaseWidget

class OverlayApp(OverlayBaseWidget):
    def update_view(self):
        _, image = self.video_source.read()
        self.vtk_overlay_window.set_video_image(image)
        self.vtk_overlay_window.Render()

if __name__ == '__main__':
    video_source = 0
    viewer = OverlayApp(video_source)
    model_dir = '../models'
    viewer.add_vtk_models_from_dir(model_dir)
    viewer.show()
    viewer.start()
    sys.exit(app.exec_())

2. 处理Wayland警告（可选） #

针对终端中出现的Wayland警告，可通过设置环境变量指定Qt运行平台来消除：

QT_QPA_PLATFORM=wayland python overlay.py

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