QWebEnginePage::acceptNavigationRequest()点击链接时未触发的问题及Qt行为咨询

我来帮你拆解这个问题，同时讲讲QWebEngine处理链接点击时的底层逻辑，以及如何解决你的问题。

为什么acceptNavigationRequest()没被触发？ #

最可能的原因是你设置的链接href="linkAction"是一个无上下文的相对路径，而调用setHtml()时没有传入基础URL（baseUrl）。QWebEngine基于Chromium内核，对URL的格式要求比老的QWebKit严格得多：

• 当你调用setHtml()只传HTML内容时，QWebEngine会默认用一个空白的基础URL，这时候像linkAction这种纯文本的href无法被解析成合法的QUrl；
• 这种无效URL的导航请求，Chromium内部可能直接拦截掉了，根本不会走到你重写的acceptNavigationRequest()方法，最终导致页面空白（因为它尝试加载一个不存在的资源）。

Qt点击链接时的完整行为逻辑 #

当用户点击<a>标签时，QWebEngine的处理流程是这样的：

1. 首先根据当前页面的基础URL，把href里的相对路径解析成完整的绝对URL；
2. 然后发起导航请求，这个请求会先传递到你重写的acceptNavigationRequest()方法；
3. 如果你的方法返回true，QWebEngine会正常加载这个URL；如果返回false，则取消导航；
4. 如果href无法被解析成合法URL（比如你的情况），Chromium会直接尝试加载无效资源，跳过你的拦截逻辑，最终页面变空白。

解决步骤 #

1. 给setHtml()添加基础URL参数

修改你的setHtml()调用，传入一个自定义的scheme（比如myapp://）作为基础URL，确保链接能被解析成合法的QUrl：

m_webView->setHtml(
    "<html><body>Some Text and a <li><a href=\"linkAction\">Link</a></li></body>",
    QUrl("myapp://base/") // 自定义基础URL，让相对路径能被正确解析
);

这样点击链接时，解析后的URL会是myapp://base/linkAction，属于合法URL，会正常触发acceptNavigationRequest()。

2. 检查自定义Page类的信号声明

确保你的MyWebEnginePage类里正确声明了linkClicked信号，头文件里要包含Q_OBJECT宏：

class MyWebEnginePage : public QWebEnginePage
{
    Q_OBJECT // 必须添加这个宏才能使用信号槽
public:
    explicit MyWebEnginePage(QObject *parent = nullptr) : QWebEnginePage(parent) {}

    bool acceptNavigationRequest(const QUrl &url, NavigationType type, bool isMainFrame) override;

signals:
    void linkClicked(const QUrl &url); // 信号声明要正确
};

3. 调试验证

可以在acceptNavigationRequest()里加调试输出，确认方法是否被调用：

bool MyWebEnginePage::acceptNavigationRequest(const QUrl &url, QWebEnginePage::NavigationType type, bool isMainFrame)
{
    qDebug() << "Navigation request received:" << url << "Type:" << type;
    if( type == QWebEnginePage::NavigationTypeLinkClicked )
    {
        emit linkClicked( url );
        return false;
    }
    return QWebEnginePage::acceptNavigationRequest( url, type, isMainFrame );
}

额外说明 #

如果你的链接是用来触发应用内动作的，也可以直接给href设置自定义scheme的绝对路径（比如href="myapp://linkAction"），这样即使不传baseUrl也能被正确解析，不过添加baseUrl是更规范的做法。

备注：内容来源于stack exchange，提问作者JW16