webkit2GTK中修改HTTP Headers遇阻，求可行解决方案

webkit2GTK完全支持修改HTTP请求头，你遇到的问题主要是信号时机选择错误或API用法不当，以下是具体解决思路：

一、正确使用resource-load-starting信号 #

resource-load-started信号触发时请求已经发送，此时修改头信息完全无效，必须用resource-load-starting——这个信号是在请求即将发起前触发，是修改头的最佳时机。

示例代码（C语言）：

static void on_resource_load_starting(WebKitWebView* web_view, WebKitResourceRequest* request, WebKitResourceResponse* redirect_response, gpointer user_data) {
    SoupMessage* msg = webkit_resource_request_get_message(request);
    if (!msg) return;

    // 替换Accept头为自定义值，而非单纯移除
    soup_message_headers_replace(soup_message_get_request_headers(msg), "Accept", "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8");
    // 若需移除特定头，需确保后续无其他逻辑重新补回
    // soup_message_headers_remove(soup_message_get_request_headers(msg), "X-Unwanted-Header");
}

// 在WebView创建后立即连接信号
webkit_web_view_connect(WEBKIT_WEB_VIEW(web_view), "resource-load-starting", G_CALLBACK(on_resource_load_starting), NULL);

注意：不要仅调用soup_message_headers_remove，很多网站检测的是Accept头的存在及具体值，单纯移除可能会触发WebKit自动补回默认值，导致检测结果无变化。

二、WebExtension的send-request信号正确用法 #

如果使用WebExtension，需确保以下几点：

• 扩展已通过webkit_web_context_install_web_extensions正确注册并加载
• 回调中必须修改details.requestHeaders并返回，同时指定blocking权限：

browser.webRequest.onSendHeaders.addListener(
    function(details) {
        // 遍历并修改Accept头
        let acceptHeader = details.requestHeaders.find(h => h.name.toLowerCase() === "accept");
        if (acceptHeader) {
            acceptHeader.value = "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8";
        } else {
            details.requestHeaders.push({name: "Accept", value: "自定义值"});
        }
        return {requestHeaders: details.requestHeaders};
    },
    {urls: ["<all_urls>"]}, // 匹配所有请求，避免漏掉子资源
    ["blocking", "requestHeaders"] // 必须指定blocking才能生效修改
);

关键是添加blocking权限，否则修改不会被应用；同时要覆盖所有URL，避免仅修改主文档请求而忽略静态资源、API请求等。

三、更简便的全局修改方式？ #

webkit2GTK没有直接修改全局默认请求头的高层API，但如果需要全局统一修改，可通过自定义SoupSession实现：

• 创建自定义SoupSession并设置默认头
• 将其绑定到WebContext，示例：

SoupSession* custom_session = soup_session_new_with_options(SOUP_SESSION_USER_AGENT, "你的自定义UA", NULL);
SoupMessageHeaders* default_headers = soup_session_get_request_default_headers(custom_session);
soup_message_headers_replace(default_headers, "Accept", "自定义Accept值");
webkit_web_context_set_soup_session(webkit_web_context_get_default(), custom_session);
g_object_unref(custom_session);

这种方式适合全局统一配置，但无法处理动态或请求差异化修改，灵活度不如信号/WebExtension方案。

排查要点 #

• 检查是否有其他代码（如WebKit内部逻辑、其他扩展）在你修改后重新覆盖请求头
• 用soup_message_headers_foreach打印修改后的头信息，确认修改确实生效
• 针对HTTPS请求，排查是否因证书问题导致请求被重定向或拦截

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