.NET MAUI中如何打开浏览器并监听重定向实现Firebase认证？

问题描述 #

• 开发.NET MAUI应用时，使用FirebaseAuthentication.net NuGet包的SignInWithRedirectAsync实现Firebase第三方登录（如Google）
• 最初采用Browser.Default.OpenAsync调用浏览器，但该方法仅返回布尔值表示浏览器是否打开，无法获取重定向后的认证结果
• 改用WebAuthenticator后，浏览器抛出错误："Unable to process request due to missing initial state. This may happen if browser sessionStorage is inaccessible or accidentally cleared"

现有代码 #

Firebase登录服务初始化 #

public LoginService(IHttpService httpService)
{
    var config = new FirebaseAuthConfig
    {
        ApiKey = API_KEY,
        AuthDomain = DOMAIN,
        Providers = new FirebaseAuthProvider[]
        {
            new EmailProvider(),
            new FacebookProvider(),
            new GoogleProvider()
        },
    };

    client = new FirebaseAuthClient(config);
    
    _httpService = httpService;
}

Google登录实现（含WebAuthenticator尝试） #

public async Task<bool> GoogleLogin()
{
    try
    {
        await client.SignInWithRedirectAsync(FirebaseProviderType.Google, async uri =>
        {
            var options = new WebAuthenticatorOptions
            {
                Url = new Uri(uri),
                CallbackUrl = new Uri("com.companyname.myappname.maui://callback/"),
            };

            var res = await WebAuthenticator.Default.AuthenticateAsync(options);

            return "";
        });

        return false;
    }
    catch (Exception ex)
    {
        return false;
    }
}

Android平台回调Activity #

using Android.App;
using Android.Content.PM;

namespace YourNameSpace;

[Activity(NoHistory = false, LaunchMode = LaunchMode.SingleTop, Exported = true)]
[IntentFilter(new[] { Android.Content.Intent.ActionView },
              Categories = new[] { Android.Content.Intent.CategoryDefault, Android.Content.Intent.CategoryBrowsable },
              DataPath = "/callback/",
              DataScheme = "com.companyname.myappname.maui")]
public class WebAuthenticationCallbackActivity : WebAuthenticatorCallbackActivity
{

}

问题原因及解决方案 #

1. 错误核心原因 #

SignInWithRedirectAsync的委托函数要求返回认证完成后的完整重定向URL，但当前代码返回空字符串""，导致Firebase无法解析认证所需的状态参数，进而抛出"missing initial state"错误。

2. 正确实现步骤 #

步骤1：修正WebAuthenticator返回值处理

修改GoogleLogin方法，将WebAuthenticator获取到的完整回调URL返回给Firebase：

public async Task<bool> GoogleLogin()
{
    try
    {
        var authResult = await client.SignInWithRedirectAsync(FirebaseProviderType.Google, async uri =>
        {
            var options = new WebAuthenticatorOptions
            {
                Url = new Uri(uri),
                CallbackUrl = new Uri("com.companyname.myappname.maui://callback/"),
            };

            // 获取认证后的完整回调URL
            var authResponse = await WebAuthenticator.Default.AuthenticateAsync(options);
            // 将回调URL返回给Firebase解析认证结果
            return authResponse.CallbackUrl.ToString();
        });

        // 登录成功后处理用户信息
        if (authResult?.User != null)
        {
            // 示例：保存用户Token、ID等信息
            // var token = await authResult.User.GetIdTokenAsync();
            return true;
        }
        return false;
    }
    catch (Exception ex)
    {
        // 异常处理，如日志记录
        return false;
    }
}

步骤2：校验Firebase平台配置

• 登录Firebase控制台，确认对应平台（Android/iOS）的回调URL配置正确：
  • Android：包名、SHA-1指纹需与项目一致，回调URL需包含自定义Scheme（如com.companyname.myappname.maui）
  • iOS：在Info.plist中添加URL Scheme，值为自定义的Scheme字符串

步骤3：Android平台配置校验

• 确保WebAuthenticationCallbackActivity的命名空间与项目完全一致
• 确认IntentFilter中的DataScheme、DataPath与回调URL完全匹配，且Exported = true（Android 12+强制要求）

步骤4：sessionStorage异常处理（可选）

若仍出现sessionStorage相关错误，可尝试：

• 保持WebAuthenticator默认的内嵌浏览器模式（不要强制使用外部浏览器）
• 清理应用缓存后重新测试

关键说明 #

• SignInWithRedirectAsync的委托函数核心作用是传递认证完成后的完整回调URL，Firebase会从中解析令牌、状态等关键参数
• WebAuthenticator是MAUI官方推荐的OAuth认证重定向处理组件，相比Browser.OpenAsync能完整捕获回调结果，适合这类认证场景

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