PySide6登录界面中os.system阻塞UI致加载提示无法显示的问题

问题背景 #

我是Python新手，用PySide6开发网络存储登录GUI，核心功能包括：

• 获取用户名、密码输入
• 检测网络连接（无连接时显示错误）
• 通过单选框选择storage1/storage2存储节点
• 创建挂载目录并执行挂载命令，成功后保存配置并退出

现在遇到的问题：在button_login_clicked函数开头调用self.loading_message.show()后，加载提示不会立即显示，要等到挂载命令执行失败才会出现。更换os.system为subprocess.call后问题依旧，推测是UI线程被耗时操作阻塞，需要Qt多线程的解决方案。

原代码 #

def button_login_clicked(self):
    user = self.username_field.text()
    password = self.password_field.text()

    try:
        socket.create_connection(("www.google.com", 80))
        internet = ""
    except OSError:
        internet = "no internet"

    if internet != "":
        self.select_storage_label.hide()
        self.wrong_credentials_label.hide()
        self.no_internet_label.hide()
        self.no_internet_label.show()
    else:
        if self.storage_option != "":
            if self.system == "posix":
                os.system("if ! [ -e /mnt/share ] ; then mkdir /mnt/share ; chown user. /mnt/share ; fi")
                mount = os.system(f"mount -t cifs //000.00.000.0/{self.storage_option} /mnt/share/ -o uid=user,username={user},password={password},iocharset=utf8,sec=ntlmssp 2>/dev/null")
            else:
                # Mount network share on Windows
                mount = os.system(f"net use Z: \\000.00.000.0\{self.storage_option} /user:{user} {password} /persistent:Yes")
            if mount != 0:
                self.select_storage_label.hide()
                self.no_internet_label.hide()
                self.wrong_credentials_label.hide()
                self.wrong_credentials_label.show()
            else:
                with open('login.conf', 'w') as file:
                    # Write to file
                    file.write(f"{user};{self.storage_option}")
                exit()
        else:
            self.select_storage_label.hide()
            self.no_internet_label.hide()
            self.wrong_credentials_label.hide()
            self.select_storage_label.show()

解决方案 #

Qt的UI线程不能执行耗时操作（比如网络检测、系统命令），否则会阻塞UI刷新。我们需要把这些耗时逻辑放到子线程中，通过信号与UI线程通信。

1. 创建工作线程类 #

继承QThread，将网络检测、挂载命令等耗时操作放到run方法里，通过信号向UI线程传递结果：

from PySide6.QtCore import QThread, Signal
import socket
import os

class MountWorker(QThread):
    finished = Signal()
    error_occurred = Signal(str)  # 传递错误类型：no_internet/no_storage_selected/wrong_credentials
    success = Signal(str, str)    # 传递用户名和存储选项用于保存配置

    def __init__(self, user, password, storage_option, system):
        super().__init__()
        self.user = user
        self.password = password
        self.storage_option = storage_option
        self.system = system

    def run(self):
        # 检测网络连接
        try:
            socket.create_connection(("www.google.com", 80), timeout=5)
        except OSError:
            self.error_occurred.emit("no_internet")
            return

        # 检查存储节点是否选择
        if not self.storage_option:
            self.error_occurred.emit("no_storage_selected")
            return

        # 执行挂载操作
        mount_result = 0
        if self.system == "posix":
            # 创建挂载目录
            os.system("if ! [ -e /mnt/share ] ; then mkdir /mnt/share ; chown user. /mnt/share ; fi")
            # 执行挂载命令
            mount_result = os.system(f"mount -t cifs //000.00.000.0/{self.storage_option} /mnt/share/ -o uid=user,username={self.user},password={self.password},iocharset=utf8,sec=ntlmssp 2>/dev/null")
        else:
            # Windows挂载命令（注意转义反斜杠）
            mount_result = os.system(f"net use Z: \\\\000.00.000.0\\{self.storage_option} /user:{self.user} {self.password} /persistent:Yes")

        if mount_result != 0:
            self.error_occurred.emit("wrong_credentials")
            return

        # 挂载成功，发送信号
        self.success.emit(self.user, self.storage_option)
        self.finished.emit()

2. 修改UI线程的登录按钮点击事件 #

在原方法中启动子线程，显示加载提示，并连接信号处理UI更新：

def button_login_clicked(self):
    user = self.username_field.text()
    password = self.password_field.text()

    # 立即显示加载提示
    self.loading_message.show()
    # 禁用登录按钮，防止重复触发
    self.login_button.setEnabled(False)

    # 初始化工作线程
    self.worker = MountWorker(user, password, self.storage_option, self.system)
    # 连接信号到处理函数
    self.worker.error_occurred.connect(self.handle_login_error)
    self.worker.success.connect(self.handle_login_success)
    self.worker.finished.connect(self.cleanup_worker)

    # 启动子线程
    self.worker.start()

def handle_login_error(self, error_type):
    # 隐藏加载提示
    self.loading_message.hide()
    # 隐藏所有错误标签，显示对应错误
    self.select_storage_label.hide()
    self.wrong_credentials_label.hide()
    self.no_internet_label.hide()

    if error_type == "no_internet":
        self.no_internet_label.show()
    elif error_type == "no_storage_selected":
        self.select_storage_label.show()
    elif error_type == "wrong_credentials":
        self.wrong_credentials_label.show()
    # 恢复登录按钮状态
    self.login_button.setEnabled(True)

def handle_login_success(self, user, storage_option):
    # 保存配置文件
    with open('login.conf', 'w') as file:
        file.write(f"{user};{storage_option}")
    # 退出程序
    exit()

def cleanup_worker(self):
    # 清理线程资源，避免内存泄漏
    self.worker.deleteLater()

关键说明 #

• 子线程中绝对不能直接操作UI元素，必须通过信号传递给UI线程处理
• 启动线程后禁用登录按钮，避免用户重复点击触发多次操作
• 线程结束后调用deleteLater()释放资源，符合Qt的内存管理规范

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