MAUI应用iOS端WillPresentNotification未触发问题求助

DevOps 小满

2026-7-8

iOS端WillPresentNotification未触发的排查方向

通知权限配置不全
主应用可能未完整请求前台通知权限。确保在调用UNUserNotificationCenter.Current.RequestAuthorizationAsync时，参数包含UNAuthorizationOptions.Alert | UNAuthorizationOptions.Sound | UNAuthorizationOptions.Badge，特别是UNAuthorizationOptions.Alert——缺少这个权限的话，iOS不会在前台弹出通知，自然不会触发WillPresentNotification。测试应用可能默认请求了完整权限，而主应用权限请求逻辑有遗漏。
Firebase推送Payload格式错误
检查主应用接收的推送Payload是否包含mutable-content: 1字段。只有携带该字段的推送，iOS才会调用WillPresentNotification允许自定义前台展示；如果缺失，系统会直接按后台通知处理，不会触发该方法。另外，若Payload仅包含content-available:1（静默通知），也不会触发前台通知回调。
Delegate注册时机过晚
主应用中UNUserNotificationCenter.Current.Delegate的绑定时机可能滞后，比如在OnStart之后才设置，导致推送到达时Delegate尚未生效。需确保在iOS项目的AppDelegate.cs的FinishedLaunching方法中尽早完成Delegate注册，保证应用启动时就完成绑定。
Info.plist配置遗漏
检查主应用的Info.plist：
- 是否添加UIBackgroundModes并包含remote-notification项；
- 是否设置FirebaseAppDelegateProxyEnabled为YES——这个代理配置是Firebase推送正常工作的必要项，缺失可能导致通知处理流程异常。
Delegate实现的Export标记缺失
确认主应用中UNUserNotificationCenterDelegate的WillPresentNotification方法是否添加了[Export("userNotificationCenter:willPresentNotification:withCompletionHandler:")]属性。MAUI中必须通过这个Export标记让iOS系统识别并调用该方法，若遗漏则回调不会触发。
第三方库冲突
主应用若集成了其他推送、权限类第三方库，可能存在Delegate被覆盖的情况，导致自定义的通知回调失效。可以暂时移除可疑库，验证是否恢复正常。