Maui集成Firebase时Google登录报错：MauiContext Is Null

问题场景 #

在MAUI应用中使用Firebase-Authentication-Dotnet NuGet包（参考MAUI适配分支）集成Firebase认证，登录界面能正常显示所有提供商，但点击「使用Google登录」时触发MauiContext Is Null异常，报错位于FirebaseAuthClient.cs的SignInWithRedirectAsync方法；continuation.Uri可在桌面浏览器正常访问，仅Email认证可正常工作。

核心解决方案 #

1. 确保MauiContext正确初始化与传递 #

创建FirebaseAuthClient实例时，必须传入有效的MauiContext，且要避免在应用启动阶段（页面未加载完成时）获取MauiContext：

// 在MAUI页面的构造函数或OnAppearing方法中初始化
protected override void OnAppearing()
{
    base.OnAppearing();
    var authConfig = new FirebaseAuthConfig
    {
        ApiKey = "你的Firebase API Key",
        AuthDomain = "你的Firebase Auth Domain",
        MauiContext = this.MauiContext, // 此处确保MauiContext不为null
        RedirectUri = new Uri("your-app-scheme://callback") // 与Firebase控制台配置一致
    };
    var authClient = new FirebaseAuthClient(authConfig);
}

如果在App.xaml.cs中初始化，需确保已加载主页面后再获取MauiContext：

// App.xaml.cs中
protected override Window CreateWindow(IActivationState activationState)
{
    var window = base.CreateWindow(activationState);
    window.PageLoaded += (s, e) =>
    {
        var mauiContext = ((Page)window.Content).MauiContext;
        // 此处初始化FirebaseAuthClient
    };
    return window;
}

2. 配置平台专属的重定向Scheme #

Google登录依赖重定向回调，需在Firebase控制台和MAUI各平台项目中同步配置：

• Firebase控制台：在「认证」→「登录方法」→「Google」中添加重定向URI，格式为your-app-scheme://callback
• Android：在AndroidManifest.xml的<application>内添加intent-filter：

<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="your-app-scheme" />
</intent-filter>

• iOS：在Info.plist中添加URL Scheme配置：

<key>CFBundleURLTypes</key>
<array>
    <dict>
        <key>CFBundleURLSchemes</key>
        <array>
            <string>your-app-scheme</string>
        </array>
    </dict>
</array>

3. 修复FirebaseAuthClient分支代码的上下文问题 #

如果使用的MAUI适配分支存在MauiContext空值问题，可手动修改FirebaseAuthClient.cs的SignInWithRedirectAsync方法：

public async Task<FirebaseAuthLink> SignInWithRedirectAsync(IProvider provider, CancellationToken cancellationToken = default)
{
    var mauiContext = _config.MauiContext;
    if (mauiContext == null)
        throw new InvalidOperationException("MauiContext Is Null");
    
    // 原有的重定向逻辑，确保使用mauiContext处理平台跳转
    var continuation = await provider.GetRedirectContinuationAsync(_config, cancellationToken);
    // ... 后续代码
}

确保方法中直接从_config获取MauiContext，而非依赖可能为空的全局变量。

其他第三方认证提供商适配经验 #

• 统一配置OAuth信息：每个提供商（Facebook、Apple等）需在Firebase控制台开启并填写对应的App ID、密钥等信息
• 平台专属配置：
  • Facebook：Android需在AndroidManifest.xml添加Facebook应用ID的meta-data；iOS需在Info.plist添加LSApplicationQueriesSchemes允许跳转至Facebook应用
  • Apple：iOS需在Info.plist添加Apple登录权限配置，Android需配置对应的服务ID
• 权限与安全设置：Android需确保开启INTERNET权限；iOS需根据需求配置NSAppTransportSecurity例外（若涉及非HTTPS链接）
• 测试注意事项：部分提供商（如Apple登录）仅支持真机测试，模拟器可能无法正常触发认证流程

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