PySide6中QWebChannel无法向JS传输数据问题求助

问题现象 #

编写了包含QWebChannel的HTML页面和PySide6代码，JS端无法触发QWebChannel的回调函数（alert('inside')不执行），导致无法获取channel.objects.backend，但相同代码切换到PyQt5后可正常运行。已确认qwebchannel.js加载正常，qt.webChannelTransport对象存在。

核心原因 #

PySide6与PyQt5在Python对象生命周期管理上存在差异，原代码中backend和channel是局部变量，在__init__函数执行完毕后可能被Python的垃圾回收机制回收，导致Qt层的通道连接失效。而PyQt5的引用计数处理逻辑避免了这个问题。

解决方案 #

将backend和channel声明为MainWindow的实例属性，确保它们的生命周期与窗口一致，不会被提前回收。同时可添加错误处理排查潜在问题。

修改后的代码 #

main.py

import sys, os

from PySide6.QtCore import Signal, QUrl, Slot, QObject
from PySide6.QtWidgets import QMainWindow, QApplication
from PySide6.QtWebEngineWidgets import QWebEngineView
from PySide6.QtWebEngineCore import QWebEngineSettings
from PySide6.QtWebChannel import QWebChannel


class Backend(QObject):
    @Slot(result=int)
    def getValue(self):
        return 1

    @Slot(int)
    def printValue(self, val):
        print(val)


class MainWindow(QMainWindow):

    def __init__(self, *args, **kwargs):
        super(MainWindow,self).__init__(*args, **kwargs)
        self.browser = QWebEngineView()
        
        # 启用开发者工具和JS支持
        self.browser.page().settings().setAttribute(QWebEngineSettings.JavascriptEnabled, True)
        self.browser.page().settings().setAttribute(QWebEngineSettings.DeveloperExtrasEnabled, True)

        # 将backend和channel设为实例属性，避免被GC回收
        self.backend = Backend()
        self.channel = QWebChannel()
        self.channel.registerObject("backend", self.backend)
        self.browser.page().setWebChannel(self.channel)

        current_dir = os.path.dirname(os.path.realpath(__file__))
        filename = os.path.join(current_dir, "index.html")
        url = QUrl.fromLocalFile(filename)
        self.browser.load(url)

        self.setCentralWidget(self.browser)
        self.resize(1200,900)
        self.show()

app = QApplication(sys.argv)
window = MainWindow()
sys.exit(app.exec())

index.html（添加错误处理）

<head>
    <title>Test</title>
     <script type="text/javascript" src="qrc:///qtwebchannel/qwebchannel.js"></script>
    <script type="text/javascript">
        let dataSource = null
        window.onload = function () {
            alert('before')
            // 添加错误回调排查问题
            new QWebChannel(qt.webChannelTransport, 
                function (channel) {
                    alert('inside')
                    dataSource = channel.objects.backend;
                    alert(dataSource)
                    // 测试调用Python方法
                    alert(dataSource.getValue())
                },
                function(error) {
                    console.error('QWebChannel初始化失败:', error)
                    alert('初始化失败: ' + error)
                }
            );
            alert('after')
        }
   </script>
</head>
<body>
<p>Hello</p>
<!-- 右键选择"检查"打开开发者工具查看控制台 -->
</body>
</html>

额外排查步骤 #

1. 打开开发者工具（右键页面→检查），查看控制台是否有报错信息，帮助定位问题。
2. 确认qt.webChannelTransport对象存在：在控制台执行console.log(qt.webChannelTransport)，若输出undefined则说明通道传输对象未正确注入。
3. 尝试调整WebChannel的设置时机：可在loadFinished信号触发后再初始化JS端的QWebChannel，确保页面完全加载完成。

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