CefSharp WPF如何在页面加载前执行JS修改UA隐藏浏览器指纹

问题本质 #

直接调用EvaluateScriptAsPromiseAsync抛出V8Context相关异常，核心原因是调用脚本时渲染进程的JS执行上下文还未完成初始化；而常规等页面加载完成事件触发后再注入脚本的时机太晚，页面自身的指纹检测脚本可能已经提前读取了真实的navigator.userAgent值，满足不了前置注入的需求。

最优实现方案 #

通过自定义渲染进程处理器，在V8上下文创建的第一时间注入脚本，该时机早于所有页面自身脚本的执行，完全满足前置注入要求，不会触发上下文不存在的异常。

实现步骤 #

• 第一步：编写自定义渲染进程处理类，重写上下文创建回调方法，注入UA覆写逻辑

using CefSharp;
using CefSharp.Handler;

public class PreInjectRenderHandler : RenderProcessHandler
{
    protected override void OnContextCreated(IWebBrowser chromiumWebBrowser, IBrowser browser, IFrame frame)
    {
        // 仅为主帧注入逻辑，需要覆盖iframe可去掉该判断
        if (!frame.IsMain) return;
        
        // 注意UA字符串不要加多余空格，否则容易被反爬识别
        const string injectScript = @"
            const fakeUserAgent = 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.60 Safari/537.36';
            // 用标准属性定义方式替代已废弃的defineGetter写法，兼容性更好
            Object.defineProperty(window.navigator, 'userAgent', {
                get: () => fakeUserAgent,
                configurable: true
            });
        ";
        frame.ExecuteJavaScriptAsync(injectScript);
    }
}

• 第二步：初始化Cef环境时注册自定义处理器，同时同步配置全局请求头UA，保证请求头和JS读取到的UA一致

var cefSettings = new CefSettings
{
    // 配置请求头UA，和注入脚本内的fakeUserAgent保持完全一致
    UserAgent = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/100.0.4896.60 Safari/537.36"
};
// 注册自定义渲染处理器
Cef.Initialize(cefSettings, performDependencyCheck: true, browserProcessHandler: null, renderProcessHandler: new PreInjectRenderHandler());

避坑说明 #

• 不要在FrameLoadEnd、LoadingStateChanged等页面加载相关事件中注入这类指纹修改脚本，这类事件触发时页面已经完成了初始脚本解析，存在真实UA被提前读取的风险
• 原代码中使用的__defineGetter__属于已废弃的非标准API，在高版本Chromium内核下存在兼容问题，统一替换为Object.defineProperty实现
• 伪造的UA字符串不要随意添加空格、特殊符号，否则会被常规反爬规则直接识别为异常指纹
• 该注入方式会在每个主帧上下文创建时自动执行，不需要手动判断CanExecuteJavascriptInMainFrame属性，不会出现V8Context不存在的异常

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