.NET 8 MAUI Blazor Hybrid应用中如何访问BlazorWebView的Cookie？

一、解决Windows平台CoreWebView2空引用问题 #

你遇到的CoreWebView2为空的问题，是因为WebView2的CoreWebView2需要完成初始化后才能访问，而OnHandlerChanged触发时初始化可能还未完成。正确做法是订阅CoreWebView2InitializationCompleted事件，等待初始化完成后再获取CookieManager：

protected override void OnHandlerChanged()
{
    base.OnHandlerChanged();
    if (blazorWebView.Handler?.PlatformView is Microsoft.UI.Xaml.Controls.WebView2 webView)
    {
        if (webView.CoreWebView2 != null)
        {
            // 已初始化，直接处理Cookie逻辑
            HandleCookieManager(webView.CoreWebView2.CookieManager);
        }
        else
        {
            // 未初始化，订阅初始化完成事件
            webView.CoreWebView2InitializationCompleted += WebView_CoreWebView2InitializationCompleted;
        }
    }
}

private void WebView_CoreWebView2InitializationCompleted(object sender, Microsoft.UI.Xaml.Controls.WebView2CoreWebView2InitializationCompletedEventArgs e)
{
    if (sender is Microsoft.UI.Xaml.Controls.WebView2 webView && e.IsSuccess)
    {
        var cookieManager = webView.CoreWebView2.CookieManager;
        HandleCookieManager(cookieManager);
        // 取消订阅避免内存泄漏
        webView.CoreWebView2InitializationCompleted -= WebView_CoreWebView2InitializationCompleted;
    }
}

private void HandleCookieManager(Microsoft.Web.WebView2.Core.CoreWebView2CookieManager cookieManager)
{
    // 示例：获取所有Cookie
    var cookies = cookieManager.GetCookies("");
    // 后续可转换为System.Net.Cookie
}

二、平台特定Cookie与System.Net.Cookie的转换 #

为避免每个平台单独处理Cookie类，可编写扩展方法将平台特定Cookie转换为标准的System.Net.Cookie：

Windows平台转换示例 #

public static System.Net.Cookie ToSystemNetCookie(this Microsoft.Web.WebView2.Core.CoreWebView2Cookie coreCookie)
{
    return new System.Net.Cookie
    {
        Name = coreCookie.Name,
        Value = coreCookie.Value,
        Domain = coreCookie.Domain,
        Path = coreCookie.Path,
        Expires = coreCookie.Expires,
        Secure = coreCookie.IsSecure,
        HttpOnly = coreCookie.IsHttpOnly
    };
}

使用时直接调用：

var systemCookies = cookies.Select(c => c.ToSystemNetCookie()).ToList();

Android平台转换示例 #

Android底层WebView的Android.Webkit.Cookie转换：

public static System.Net.Cookie ToSystemNetCookie(this Android.Webkit.Cookie androidCookie)
{
    return new System.Net.Cookie
    {
        Name = androidCookie.Name,
        Value = androidCookie.Value,
        Domain = androidCookie.Domain,
        Path = androidCookie.Path,
        Expires = androidCookie.Expires,
        Secure = androidCookie.Secure,
        HttpOnly = androidCookie.HttpOnly
    };
}

iOS/macOS平台转换示例 #

iOS/macOS的NSHttpCookie转换：

public static System.Net.Cookie ToSystemNetCookie(this NSHttpCookie nsCookie)
{
    return new System.Net.Cookie
    {
        Name = nsCookie.Name,
        Value = nsCookie.Value,
        Domain = nsCookie.Domain,
        Path = nsCookie.Path,
        Expires = nsCookie.ExpiresDate?.ToDateTime() ?? DateTime.MaxValue,
        Secure = nsCookie.IsSecure,
        HttpOnly = nsCookie.IsHttpOnly
    };
}

三、跨平台Cookie访问的统一封装 #

可创建接口IBlazorCookieProvider，针对各平台实现后通过依赖注入使用，避免页面中直接写平台特定代码：

public interface IBlazorCookieProvider
{
    Task<List<System.Net.Cookie>> GetCookiesAsync(string url = "");
    Task SetCookieAsync(System.Net.Cookie cookie);
}

以Windows平台实现为例：

public class WindowsBlazorCookieProvider : IBlazorCookieProvider
{
    private readonly BlazorWebView _blazorWebView;
    private Microsoft.Web.WebView2.Core.CoreWebView2CookieManager _cookieManager;

    public WindowsBlazorCookieProvider(BlazorWebView blazorWebView)
    {
        _blazorWebView = blazorWebView;
        InitializeCookieManager();
    }

    private void InitializeCookieManager()
    {
        if (_blazorWebView.Handler?.PlatformView is Microsoft.UI.Xaml.Controls.WebView2 webView)
        {
            _cookieManager = webView.CoreWebView2?.CookieManager;
            webView.CoreWebView2InitializationCompleted += (s, e) => 
            {
                if (e.IsSuccess) _cookieManager = webView.CoreWebView2.CookieManager;
            };
        }
    }

    public async Task<List<System.Net.Cookie>> GetCookiesAsync(string url = "")
    {
        if (_cookieManager == null) await WaitForInitialization();
        var coreCookies = _cookieManager.GetCookies(url);
        return coreCookies.Select(c => c.ToSystemNetCookie()).ToList();
    }

    private Task WaitForInitialization()
    {
        var tcs = new TaskCompletionSource<bool>();
        if (_blazorWebView.Handler?.PlatformView is Microsoft.UI.Xaml.Controls.WebView2 webView)
        {
            if (webView.CoreWebView2 != null)
                tcs.SetResult(true);
            else
            {
                void Handler(object s, Microsoft.UI.Xaml.Controls.WebView2CoreWebView2InitializationCompletedEventArgs e)
                {
                    tcs.SetResult(e.IsSuccess);
                    webView.CoreWebView2InitializationCompleted -= Handler;
                }
                webView.CoreWebView2InitializationCompleted += Handler;
            }
        }
        return tcs.Task;
    }

    public Task SetCookieAsync(System.Net.Cookie cookie)
    {
        if (_cookieManager == null)
            throw new InvalidOperationException("CookieManager未初始化");
            
        var coreCookie = _cookieManager.CreateCookie(cookie.Name, cookie.Value, cookie.Domain, cookie.Path);
        coreCookie.Expires = cookie.Expires;
        coreCookie.IsSecure = cookie.Secure;
        coreCookie.IsHttpOnly = cookie.HttpOnly;
        _cookieManager.AddOrUpdateCookie(coreCookie);
        return Task.CompletedTask;
    }
}

在MauiProgram.cs中注册平台特定实现：

#if WINDOWS
builder.Services.AddSingleton<IBlazorCookieProvider>(sp => 
    new WindowsBlazorCookieProvider(sp.GetRequiredService<BlazorWebView>()));
#elif ANDROID
// 注册Android平台实现
#elif IOS || MACCATALYST
// 注册iOS/macOS平台实现
#endif

四、BlazorWebView的Cookie访问现状说明 #

BlazorWebView确实没有像常规WebView那样直接暴露Cookies属性——它的定位是封装WebView运行Blazor应用，而非提供通用WebView的所有原生API。如果是身份验证场景，使用IPreferences/ISecureStorage配合AuthenticationStateProvider是更轻量的跨平台方案；但如果必须操作WebView原生Cookie（比如和外部网页共享Cookie），上述平台特定的访问方式是当前的标准解决方案。

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