Xamarin.Forms iOS真机无法显示FCM推送通知求助

我完全理解被这个问题卡一周的烦躁感——FCM推送在iOS上的配置细节确实容易踩坑。结合你已经完成的配置和提供的AppDelegate代码，我整理了几个关键的排查和修复方向，你可以逐一验证：

1. 核对APNs证书与Firebase的匹配度 #

• 确保你在Apple开发者后台创建的是Production环境的推送证书，真机测试必须用生产证书，开发证书只适用于模拟器或开发环境的真机调试。
• 把导出的.p12证书上传到Firebase控制台的「项目设置 > 云消息传递 > iOS应用」时，确认证书绑定的Bundle ID和你的App完全一致，大小写、拼写都不能错。
• 如果你的App用到了App Groups，检查Entitlements.plist里的推送权限（aps-environment）和App Groups配置有没有冲突，比如是否误把aps-environment设置成了开发环境。

2. 验证FCM Token与APNs Token的关联 #

你的代码里已经写了Messaging.SharedInstance.ApnsToken = deviceToken;，但要确认：

• 在RegisteredForRemoteNotifications方法中，能正常获取到APNs的deviceToken，可以打印出来看看是不是有效的二进制数据（不是空值或乱码）。
• 检查DidReceiveRegistrationToken回调输出的FCM Token，和你在Firebase控制台测试时粘贴的完全一致，避免复制时多了空格或者少了字符。

3. 修复AppDelegate中的通知注册逻辑 #

看你的代码，iOS 10+的权限请求逻辑里缺少了注册远程通知的调用，这会导致设备拿不到APNs Token，FCM自然无法推送：

if (UIDevice.CurrentDevice.CheckSystemVersion(10, 0)) {
    UNUserNotificationCenter.Current.Delegate = this;
    var authOptions = UNAuthorizationOptions.Alert | UNAuthorizationOptions.Badge | UNAuthorizationOptions.Sound;
    UNUserNotificationCenter.Current.RequestAuthorization(authOptions, (granted, error) => {
        Console.WriteLine(granted);
        // 新增：用户授权后才注册远程通知
        if (granted && error == null) {
            UIApplication.SharedApplication.RegisterForRemoteNotifications();
        }
    });
}

另外，你在方法末尾重复调用了RegisterForRemoteNotifications()，虽然不会报错，但最好把注册逻辑统一放到权限回调里，确保只有用户允许通知后才发起注册。

4. 确认后台模式的完整配置 #

在Info.plist中，除了开启后台模式和远程通知，还要检查：

• UIBackgroundModes数组里必须包含remote-notification项，正确的XML配置应该是：

<key>UIBackgroundModes</key>
<array>
    <string>remote-notification</string>
</array>

• 检查是否存在FirebaseAppDelegateProxyEnabled键，要是有的话确保值为YES（默认是开启的，但如果手动修改过可能影响FCM的代理逻辑）。

5. 规范测试推送的格式 #

用Firebase控制台发测试消息时，注意这几点：

• 一定要选择生产环境发送，因为真机用的是Production APNs证书，开发环境的消息推不到真机上。
• 消息必须包含alert字段，纯数据消息（只有data部分）在iOS后台不会自动弹出通知，需要你在DidReceiveRemoteNotification里手动构建本地通知。
• 可以同时加上badge: 1和sound: default，这样更容易判断通知是否被设备接收。

6. 检查设备的通知设置 #

• 打开真机的「设置 > 你的App > 通知」，确认已经开启「允许通知」，并且「通知样式」设为了横幅或提醒，声音、标记也都开启了。
• 暂时关闭设备的「专注模式」或「勿扰模式」，这些功能会屏蔽通知，导致你看不到推送。

7. 用调试日志定位问题 #

连接真机到Visual Studio/Xamarin Studio调试，盯着控制台输出：

• 确认RegisteredForRemoteNotifications是否被触发，deviceToken有没有正常输出。
• 确认DidReceiveRegistrationToken输出的FCM Token是有效的。
• 发送测试消息后，看WillPresentNotification（App前台时）或DidReceiveNotificationResponse（点击通知时）有没有被调用，userInfo里的内容是否和你发送的一致。

先从证书和注册逻辑这两个最常见的坑入手，应该能快速找到问题所在。

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