在PyQt6的QWebEngineView中拦截格式错误的链接点击

问题分析 #

当点击test_bad_link这类不符合URL规范的链接时，Qt原生的QWebEnginePage::acceptNavigationRequest和QWebEngineUrlRequestInterceptor不会被触发——这类链接会被WebEngine直接判定为无效导航，直接跳转到空白页，绕开了常规的导航拦截流程。

解决方案 #

通过JavaScript注入+QWebChannel的方式，前端捕获所有<a>标签的点击事件，阻止默认跳转行为，再把链接内容传递给Python端处理。这种方式能覆盖所有类型的链接，无论是否符合URL规范。

完整代码示例 #

from PyQt6.QtWidgets import QApplication, QWebEngineView
from PyQt6.QtWebEngineCore import QWebEnginePage
from PyQt6.QtWebChannel import QWebChannel
import sys

class WebPage(QWebEnginePage):
    def __init__(self, parent=None):
        super().__init__(parent)
        self.channel = QWebChannel()
        self.channel.registerObject("pyHandler", self)
        self.setWebChannel(self.channel)

    # 供JS调用的Python方法，处理链接点击逻辑
    def handleLinkClick(self, href):
        print(f"点击的链接内容: {href}")

app = QApplication(sys.argv)
view = QWebEngineView()
page = WebPage()
view.setPage(page)

# 注入JS代码：拦截所有a标签点击，传递链接给Python
js_intercept_code = """
new QWebChannel(qt.webChannelTransport, function(channel) {
    const pyHandler = channel.objects.pyHandler;
    // 全局监听点击事件，捕获所有a标签
    document.addEventListener('click', function(e) {
        let target = e.target;
        // 向上遍历DOM树，找到最上层的a标签
        while (target && target.tagName !== 'A') {
            target = target.parentNode;
        }
        if (target) {
            e.preventDefault(); // 阻止默认跳转行为
            const rawHref = target.getAttribute('href'); // 获取原始href属性值
            pyHandler.handleLinkClick(rawHref);
        }
    });
});
"""

# 带QWebChannel依赖的HTML内容
html_content = """
<html>
<head>
    <!-- 引入Qt内置的WebChannel脚本，必须添加 -->
    <script src="qrc:///qtwebchannel/qwebchannel.js"></script>
</head>
<body>
    <a href="test_bad_link">test</a>
    <br>
    <a href="http://www.example.com">test well formated</a>
</body>
</html>
"""

view.setHtml(html_content)
# 页面加载完成后再注入拦截JS，确保DOM元素已生成
view.page().loadFinished.connect(lambda: view.page().runJavaScript(js_intercept_code))
view.show()

sys.exit(app.exec())

代码说明 #

1. QWebChannel通信：建立Python与前端JS的双向通信通道，将Python的WebPage对象注册为pyHandler，让JS可以直接调用其方法。
2. JS全局拦截：通过document.addEventListener捕获所有点击事件，遍历DOM找到被点击的<a>标签，调用preventDefault()阻止默认跳转，再将原始链接内容传给Python。
3. 依赖脚本引入：HTML中必须引入Qt内置的qwebchannel.js，否则无法建立通信通道。
4. 时机控制：通过loadFinished信号确保页面加载完成后再注入JS，避免DOM元素未生成导致拦截逻辑失效。

效果验证 #

• 点击test（无效链接）：控制台打印点击的链接内容: test_bad_link，页面无跳转。
• 点击test well formated（有效URL）：控制台打印点击的链接内容: http://www.example.com，页面无跳转。

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