如何将异步函数连接到PySide6按钮的clicked信号？

PySide6的信号槽机制不直接支持异步函数，直接连接会导致协程未被等待，触发RuntimeWarning。以下是两种可行的原生解决方案：

方法一：用asyncio后台运行协程（推荐） #

这种方式不会阻塞GUI线程，适合耗时的异步任务（如网络请求、IO操作）。通过同步包装函数调用asyncio.create_task启动协程，让异步任务在后台执行。

修改后的完整代码：

from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton
import asyncio


class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Async Function Example")
        self.login_button = QPushButton("Login", self)
        # 连接到同步包装函数
        self.login_button.clicked.connect(self.on_login_clicked)

    async def login_button_clicked(self):
        # 模拟异步任务（如网络请求）
        await asyncio.sleep(1)
        print("test async button clicked!")

    def on_login_clicked(self):
        # 启动协程，不阻塞GUI
        asyncio.create_task(self.login_button_clicked())


app = QApplication([])
window = MainWindow()
window.show()
app.exec()

方法二：用Qt事件循环等待协程完成 #

这种方式会阻塞GUI线程直到异步任务结束，仅适合短耗时任务。通过QEventLoop等待协程执行完毕。

修改后的完整代码：

from PySide6.QtWidgets import QApplication, QMainWindow, QPushButton
from PySide6.QtCore import QEventLoop
import asyncio


class MainWindow(QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle("Async Function Example")
        self.login_button = QPushButton("Login", self)
        self.login_button.clicked.connect(self.on_login_clicked)

    async def login_button_clicked(self):
        await asyncio.sleep(1)
        print("test async button clicked!")

    def on_login_clicked(self):
        loop = QEventLoop()
        # 将协程转为Future并绑定结束回调
        future = asyncio.ensure_future(self.login_button_clicked())
        future.add_done_callback(lambda _: loop.quit())
        # 启动Qt事件循环等待协程完成
        loop.exec()

注意事项 #

• 方法一的异步任务会在后台运行，若需要更新GUI，必须通过QtCore.QMetaObject.invokeMethod确保在GUI线程执行更新操作。
• 若需要深度整合Qt事件循环与asyncio事件循环，可以使用第三方库qtasync，但原生方法已覆盖大部分场景需求。

内容的提问来源于stack exchange，提问作者Mehdi Ben Hamida