.NET MAUI .NET 8 iOS平台Azure Notification Hub推送通知排障与测试

一、iOS本地配置排查 #

• APNs证书有效性检查
  1. 登录苹果开发者后台，确认Push Notifications证书未过期，且绑定正确的App ID（区分开发/生产环境）。
  2. 证书导出为.p12格式时必须设置非空密码，上传到Azure Notification Hub时需严格匹配环境（沙盒对应开发证书，生产对应发布证书）。
• App ID与Provisioning Profile配置
  确保App ID已开启Push Notifications权限，当前使用的Provisioning Profile包含该权限，且Xcode中已正确选择对应Profile。
• 设备通知权限验证
  在iOS设备的「设置」→「通知」→「你的App」中，确认已开启「允许通知」，并启用横幅、声音等必要通知选项。
• 环境一致性校验
  Debug模式运行App时，Azure需配置沙盒证书；Release模式需配置生产证书，环境不匹配会直接导致推送失败。

二、Azure Notification Hub配置排查 #

• 连接字符串权限
  推送操作使用DefaultFullSharedAccessSignature（发送权限），客户端注册使用DefaultListenSharedAccessSignature（监听权限），避免权限错配。
• 注册标签/模板匹配
  测试阶段优先选择「发送到所有注册设备」，排除标签/模板匹配问题；若使用标签，需确保推送目标标签与客户端注册标签完全一致。
• 推送日志分析
  在Azure门户的通知集线器中，进入「监控」→「日志」，查看推送请求的状态详情。重点关注：证书无效、设备Token过期、目标设备不存在等错误提示。

三、客户端代码排查 #

• 设备Token处理
  在iOS项目的AppDelegate中，确保DidRegisterForRemoteNotificationsWithDeviceToken方法正确转换Token格式（移除多余空格、括号），并调用Azure SDK完成注册。可添加日志输出Token，确认格式正确。
• 清理Plugin.Firebase残留
  移除Info.plist中Firebase相关配置项、代码中Firebase初始化逻辑，避免与Azure推送逻辑冲突。
• .NET 8权限适配
  使用.NET 8兼容的权限请求方式：

  var authOptions = UNAuthorizationOptions.Alert | UNAuthorizationOptions.Sound | UNAuthorizationOptions.Badge;
  var authResult = await UNUserNotificationCenter.Current.RequestAuthorizationAsync(authOptions);
  if (authResult.Authorized)
  {
      UIApplication.SharedApplication.RegisterForRemoteNotifications();
  }
  

四、正确的测试方法 #

1. Azure门户快速测试 #

1. 进入Azure Notification Hub的「测试发送」界面。
2. 选择「iOS」平台，输入JSON格式的推送内容：{"aps":{"alert":"测试消息","sound":"default"}}。
3. 选择「发送到所有注册设备」，点击发送后查看日志及设备接收情况。

2. 后端代码测试 #

编写控制台程序使用Azure SDK发送推送，示例代码：

using Azure.Messaging.NotificationHubs;

var connectionString = "你的DefaultFullSharedAccessSignature";
var hubName = "你的通知集线器名称";
var client = new NotificationHubClient(connectionString, hubName);

var iosPayload = "{\"aps\":{\"alert\":\"控制台测试推送\",\"sound\":\"default\"}}";
var sendResult = await client.SendNotificationAsync(new AppleNotification(iosPayload));
Console.WriteLine($"推送状态：{sendResult.State}");

3. 分环境测试 #

分别在Debug（沙盒）和Release（生产）环境下测试，确保每个环境的证书、Provisioning Profile、Azure配置完全匹配。

内容的提问来源于stack exchange，提问作者Suhas M R