C# WebView2修改User-Agent不生效？求助排查解决方案

问题核心原因 #

你当前的写法存在两个关键问题：

• 使用Task.Run异步初始化WebView2，可能导致设置UserAgent时WebView已经完成初始导航，UA设置无法覆盖已加载的请求
• 仅修改CoreWebView2.Settings.UserAgent对初始页面加载这类场景可能不生效，更可靠的方式是在WebView2环境初始化阶段配置UA

有效解决办法 #

方法1：通过CoreWebView2Environment全局配置UserAgent

这是最稳定的方式，在创建WebView2运行环境时直接指定UA，所有请求都会使用该值：

public MainWindow()
{
    InitializeComponent();
    Title = "mainWindow";
    InitializeWebView2();
}

private async void InitializeWebView2()
{
    // 创建带自定义UA的环境配置
    var envOptions = new CoreWebView2EnvironmentOptions
    {
        AdditionalBrowserArguments = "--user-agent=\"windows/webview2\""
    };
    var environment = await CoreWebView2Environment.CreateAsync(null, null, envOptions);
    
    // 用自定义环境初始化WebView2
    await webView.EnsureCoreWebView2Async(environment);
}

方法2：在UI线程初始化并提前设置UA

避免使用Task.Run，确保在WebView2初始化完成后、页面导航前设置UA，之后刷新页面生效：

public MainWindow()
{
    InitializeComponent();
    Title = "mainWindow";
    webView.CoreWebView2InitializationCompleted += WebView_CoreWebView2InitializationCompleted;
}

private void WebView_CoreWebView2InitializationCompleted(object sender, CoreWebView2InitializationCompletedEventArgs e)
{
    if (e.IsSuccess)
    {
        // 设置自定义UA
        webView.CoreWebView2.Settings.UserAgent = "windows/webview2";
        // 刷新当前页面使UA生效
        webView.CoreWebView2.Reload();
    }
}

验证方式

设置完成后，可通过以下方式确认UA是否生效：

• 在WebView2中打开开发者工具（按F12），切换到网络标签页，刷新页面后查看任意请求的User-Agent请求头
• 执行JS代码console.log(navigator.userAgent)，在控制台查看输出值

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