PySide6 GUI执行SAP长耗时任务时冻结问题求助

核心问题分析 #

1. QThread使用范式错误：你的Executora继承了QThread却又调用moveToThread，违背了QThread的设计逻辑——QThread是线程容器，worker应作为普通QObject被移动到线程中运行。
2. SAP对象线程绑定限制：SAP的SAPEngineScript属于COM对象，默认绑定到创建它的线程（单线程公寓模型），跨线程访问必然导致崩溃，必须在工作线程内部创建Conexoes实例。
3. 不安全的函数调用方式：使用eval(f'processo.{aExecutar}')存在安全风险且可读性差，应替换为getattr。
4. 信号定义缺失：代码中尝试发射error信号，但Sinais类未定义该信号，导致运行时错误。

修复后的代码实现 #

1. 重构Worker类（使用QRunnable + QThreadPool） #

推荐用QRunnable配合QThreadPool，更适配你70-100个页面的批量任务管理场景：

import ui_nova
from PySide6.QtCore import (Signal, QObject, QRunnable, Slot, QThreadPool)
from PySide6 import QtCore, QtGui, QtWidgets
from PySide6.QtWidgets import (QApplication, QMainWindow, QWidget)
import conexoes
import sys
import traceback


class WorkerSignals(QObject):
    finished = Signal()
    error = Signal(tuple)  # 补充缺失的错误信号
    progress = Signal(int)


class SAPWorker(QRunnable):
    def __init__(self, func_name):
        super().__init__()
        self.func_name = func_name
        self.signals = WorkerSignals()

    @Slot()
    def run(self):
        # 关键：在工作线程内部创建Conexoes实例，确保SAP对象归属当前线程
        processo = conexoes.Conexoes()
        try:
            # 用getattr替代eval，更安全且易维护
            target_func = getattr(processo, self.func_name)
            target_func()
        except Exception:
            traceback.print_exc()
            exctype, value, tb = sys.exc_info()
            self.signals.error.emit((exctype, value, traceback.format_exc()))
        else:
            print(f"任务 {self.func_name} 执行完成")
        finally:
            self.signals.finished.emit()

2. 主窗口类调整 #

class UIMainConexao(QMainWindow, ui_nova.Ui_MainWindow):
    def __init__(self):
        super().__init__()
        self.setupUi(self)
        self.MainWW.setWindowFlags(QtCore.Qt.FramelessWindowHint)
        self.MainWW.setAttribute(QtCore.Qt.WA_TranslucentBackground)
        self.buttonFechar.clicked.connect(self.close)
        self.buttonMinimizar.clicked.connect(self.showMinimized)
        
        # 初始化线程池，根据SAP并发限制调整线程数（SAP通常不支持高并发）
        self.threadpool = QThreadPool()
        self.threadpool.setMaxThreadCount(1)  # 建议设为1，避免SAP连接冲突
        print(f"线程池最大线程数：{self.threadpool.maxThreadCount()}")
        
        self.offset = None
        self.frameToolBar.installEventFilter(self)
        
        self.buttonHome.clicked.connect(lambda: self.stackedWidget.setCurrentWidget(self.pageInicial))
        self.buttonUserConfig.clicked.connect(lambda: self.stackedWidget.setCurrentWidget(self.pageUser))
        self.buttonEmpresas.clicked.connect(lambda: self.execute_task("boletoBancoX"))

    def eventFilter(self, source, event):
        if source == self.frameToolBar:
            if event.type() == QtCore.QEvent.MouseButtonPress:
                self.offset = event.pos()
            elif event.type() == QtCore.QEvent.MouseMove and self.offset is not None:
                self.move(self.pos() - self.offset + event.pos())
                return True
            elif event.type() == QtCore.QEvent.MouseButtonRelease:
                self.offset = None
        return super().eventFilter(source, event)

    def execute_task(self, func_name):
        worker = SAPWorker(func_name)
        # 绑定信号处理逻辑
        worker.signals.finished.connect(lambda: print(f"任务 {func_name} 结束"))
        worker.signals.error.connect(self.handle_task_error)
        # 提交任务到线程池
        self.threadpool.start(worker)

    def handle_task_error(self, error_info):
        exctype, value, traceback_str = error_info
        print(f"任务执行出错：{exctype.__name__}: {value}")
        print(traceback_str)
        # 此处可添加GUI错误提示，例如弹出QMessageBox

关键注意事项 #

• SAP并发限制：SAP的COM接口大多不支持多线程并发，线程池最大线程数建议设为1，避免连接冲突或对象崩溃。
• 线程隔离：所有与SAP相关的操作必须在工作线程内部完成，绝对不能在主线程创建SAP对象后跨线程调用。
• 资源清理：在Conexoes类的__del__方法中添加SAP连接的清理逻辑，确保任务完成后释放资源。
• 任务队列管理：QThreadPool会自动管理任务队列，70-100个任务会按配置的并发数顺序执行，无需手动管理线程生命周期。

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