MAUI Blazor Hybrid中Google认证的浏览器交互实现问题

问题根源 #

你之前的方案失效，核心原因是 MAUI Blazor 的 WebView 处于沙箱环境，window.open 受浏览器安全策略限制会返回 null；同时 WebView 内打开的授权页面与主应用隔离，无法直接捕获重定向回调。以下是可行的解决步骤：

1. 改用 MAUI 原生系统浏览器打开授权页面 #

放弃 JS 互操作的 window.open，直接用 MAUI 的 ILauncher 打开系统默认浏览器，既符合 Google OAuth 安全规范，也能避免 WebView 的限制。

2. 配置 Firebase 回调地址与 MAUI Deep Link #

• 在 Firebase 控制台的认证设置中，将授权回调地址设置为自定义 Deep Link（例如 myapp://auth/callback）。
• 在 MAUI 项目中配置 Deep Link 监听，让系统浏览器完成授权后能跳转回应用，并传递回调 URL。

3. 用 TaskCompletionSource 等待认证回调 #

通过异步任务等待机制，在 Deep Link 回调触发后，将授权 URL 传递给 FirebaseAuthClient 完成认证流程。

完整代码示例 #

Blazor 组件代码

@inject ILauncher Launcher

@code {
    private FirebaseAuthClient _authClient;
    private TaskCompletionSource<string> _authCallbackTcs;

    protected override void OnInitialized()
    {
        var config = new FirebaseAuthConfig
        {
            ApiKey = "你的Firebase API Key",
            AuthDomain = "你的Firebase Auth Domain",
            RedirectUri = "myapp://auth/callback" // 与Firebase配置一致的Deep Link
        };
        _authClient = new FirebaseAuthClient(config);
        _authCallbackTcs = new TaskCompletionSource<string>();
    }

    private async Task SignInWithGoogle()
    {
        try
        {
            var userCredential = await _authClient.SignInWithRedirectAsync(FirebaseProviderType.Google, async uri =>
            {
                // 用系统浏览器打开授权页面
                await Launcher.OpenAsync(new Uri(uri));
                // 等待Deep Link回调返回的授权URL
                var callbackUrl = await _authCallbackTcs.Task;
                return callbackUrl;
            });

            // 处理登录成功逻辑
            Console.WriteLine($"登录用户：{userCredential.User.DisplayName}");
        }
        catch (Exception ex)
        {
            Console.WriteLine($"登录失败：{ex.Message}");
        }
    }

    // 供MAUI主应用调用，接收Deep Link回调
    public void HandleAuthCallback(string callbackUrl)
    {
        _authCallbackTcs.TrySetResult(callbackUrl);
        _authCallbackTcs = new TaskCompletionSource<string>(); // 重置以便下次登录
    }
}

MAUI 应用配置（Android 为例）

在 AndroidManifest.xml 中添加 Deep Link 的 Intent 过滤器：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="myapp" android:host="auth" android:path="/callback" />
</intent-filter>

在 App.xaml.cs 中重写回调处理方法：

protected override void OnAppLinkRequestReceived(Uri uri)
{
    base.OnAppLinkRequestReceived(uri);

    // 判断是否为认证回调地址
    if (uri.Scheme == "myapp" && uri.Host == "auth" && uri.Path == "/callback")
    {
        // 获取Blazor组件实例并传递回调URL
        if (MainPage is BlazorWebView webView && webView.HostPage is YourAuthComponent authPage)
        {
            authPage.HandleAuthCallback(uri.ToString());
        }
    }
}

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