MAUI .NET 8中iOS端Firebase推送通知无法接收问题求助

先明确： #

已经有大量开发者在MAUI .NET 8上成功实现了Android+iOS双端的Firebase推送功能，你的问题大概率是配置环节存在遗漏，以下是针对性排查点和解决方法：

1. 必须补充Info.plist权限配置 #

iOS端需要明确配置推送相关权限和后台模式，你当前的配置中缺少这部分，需在Info.plist中添加：

<key>NSRemoteNotificationUsageDescription</key>
<string>需要推送权限接收重要通知</string>
<key>UIBackgroundModes</key>
<array>
    <string>remote-notification</string>
</array>

• NSRemoteNotificationUsageDescription：iOS 10+强制要求，用于向用户说明申请推送权限的原因
• UIBackgroundModes添加remote-notification：允许App在后台处理推送消息

2. 修正iOS初始化流程与权限请求 #

你的初始化代码仅完成了Firebase启动，但未请求推送权限，且WillFinishLaunching返回false可能中断App启动流程，建议调整：

private static MauiAppBuilder RegisterFirebaseServices(this MauiAppBuilder builder)
{
    builder.ConfigureLifecycleEvents(events =>
    {
#if IOS
        events.AddiOS(iOS => 
        {
            iOS.WillFinishLaunching((_, __) =>
            {
                CrossFirebase.Initialize();
                FirebaseCloudMessagingImplementation.Initialize();
                return true; // 改为true，确保App启动流程正常
            });
            
            iOS.FinishedLaunching((_, __) =>
            {
                // 请求推送权限
                UNUserNotificationCenter.Current.RequestAuthorization(UNAuthorizationOptions.Alert | UNAuthorizationOptions.Badge | UNAuthorizationOptions.Sound, (granted, error) =>
                {
                    if (granted)
                    {
                        InvokeOnMainThread(() => UIApplication.SharedApplication.RegisterForRemoteNotifications());
                    }
                });
                return true;
            });
        });
#endif

#if ANDROID
        events.AddAndroid(android => android.OnCreate((activity, _) =>
            CrossFirebase.Initialize(activity)));
#endif
    });

    return builder;
}

3. 完善APNs令牌与Firebase绑定 #

需要监听APNs令牌并同步给Firebase，确保推送能正确路由到设备：

// 在iOS项目的AppDelegate.cs中添加（如果没有则创建）
using Firebase.CloudMessaging;
using UserNotifications;

namespace YourAppNamespace.iOS;

[Register("AppDelegate")]
public class AppDelegate : MauiUIApplicationDelegate
{
	protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();

    public override void RegisteredForRemoteNotifications(UIApplication application, NSData deviceToken)
    {
        FirebaseCloudMessagingImplementation.ApnsToken = deviceToken;
    }

    public override void DidReceiveRemoteNotification(UIApplication application, NSDictionary userInfo, Action<UIBackgroundFetchResult> completionHandler)
    {
        FirebaseCloudMessagingImplementation.HandleMessage(userInfo);
        completionHandler(UIBackgroundFetchResult.NewData);
    }
}

同时添加令牌刷新监听，确保令牌变更时能同步：

// 在初始化代码中添加
FirebaseCloudMessagingImplementation.TokenRefresh += (s, e) =>
{
    var token = FirebaseCloudMessagingImplementation.Token;
    // 可将token上传到你的服务器，或用于Firebase控制台测试推送
};

4. 验证Firebase与Apple开发者配置 #

• 确认GoogleService-Info.plist已添加到iOS项目，且Build Action设置为BundleResource
• 检查Firebase控制台中iOS应用的APNs证书：开发环境需匹配aps-environment=development的开发证书，且证书未过期
• 确保测试设备的UDID已添加到Apple开发者账户的设备列表，且包含在对应的Provisioning Profile中

5. 测试环境注意事项 #

• 开发环境（aps-environment=development）只能使用Firebase控制台的测试消息功能推送，不能用生产消息通道
• 必须使用物理iOS设备测试，模拟器无法接收APNs推送

总结 #

iOS端无法接收推送的核心原因是缺少权限配置、未主动请求推送权限、初始化流程不完整，按照上述步骤修正后即可正常接收。

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