QtWebView中页内href链接无法显示内容的问题

我之前也碰到过一模一样的坑——用setContent加载大内容时页内链接好好的，换成自定义协议conapp://之后，点页内链接就完全没反应了。咱们一步步拆解解决：

问题根源 #

自定义SchemeHandler默认只会处理完整的conapp://<contentname>请求，但页内的相对链接（比如./subpage、../otherpage）不会自动关联到你的自定义协议上，WebView不知道这些相对路径应该映射到conapp://下的哪个资源。

具体解决方案 #

1. 正确注册自定义Scheme #

首先确保你的自定义协议被WebView信任，注册时加上必要的flags：

QWebEngineUrlScheme conappScheme("conapp");
// 标记为安全的本地协议，允许跨路径访问
conappScheme.setFlags(QWebEngineUrlScheme::SecureScheme | 
                      QWebEngineUrlScheme::LocalScheme | 
                      QWebEngineUrlScheme::LocalAccessAllowed);
QWebEngineUrlScheme::registerScheme(conappScheme);

2. 在SchemeHandler中解析相对路径 #

重写requestStarted方法时，要利用请求的Referer头（即当前页面的conapp://地址），把相对路径转换成完整的自定义协议URL：

void SchemeHandler::requestStarted(QWebEngineUrlRequestJob *job)
{
    QUrl requestUrl = job->requestUrl();
    const QByteArray referer = job->requestHeaders().value("Referer");

    // 如果是相对路径请求，基于Referer解析成完整的conapp://地址
    if (!referer.isEmpty() && !requestUrl.isValid() && requestUrl.path().startsWith("./")) {
        QUrl refererUrl(referer);
        if (refererUrl.scheme() == "conapp") {
            requestUrl = refererUrl.resolved(requestUrl);
        }
    }

    // 从内容字典中获取对应资源
    QString contentKey = requestUrl.path().remove(0, 1); // 去掉路径开头的"/"
    if (m_contentMap.contains(contentKey)) {
        QByteArray contentData = m_contentMap[contentKey];
        // 根据内容类型设置响应头，这里以HTML为例
        job->reply(QByteArrayLiteral("text/html"), new QBuffer(&contentData, job));
    } else {
        job->fail(QWebEngineUrlRequestJob::UrlNotFound);
    }
}

3. 规范页内链接写法 #

确保页内的链接使用相对路径，比如：

• 同目录下的子页面：<a href="./subpage">子页面</a>
• 上级目录的页面：<a href="../parentpage">父页面</a>
  不要写绝对路径（比如/subpage）或者默认协议的路径（比如http://xxx），否则WebView会按默认逻辑处理，不会走你的自定义SchemeHandler。

额外检查点 #

• 确认你的内容字典中已经包含了所有页内链接指向的资源key
• 如果是加载CSS、JS等静态资源，也要确保这些资源的请求被SchemeHandler正确处理（同样按相对路径解析）

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