.NET 8 MAUI能否通过Azure Notification Hubs对接FCM v1及相关问题咨询

1. 成功实现MAUI通过Azure Notification Hubs对接FCM V1的关键技巧 #

确实有开发者成功落地该方案，核心解决要点如下：

• 修正FCM V1凭证配置
  你遇到的Invalid Fcm V1 credential报错，本质是密钥格式或内容错误。从Firebase控制台下载的服务账号JSON文件中：

  • private_key字段是PKCS8格式密钥，必须完整复制，包括首尾的-----BEGIN PRIVATE KEY-----和-----END PRIVATE KEY-----，不能遗漏任何字符，也不要手动修改换行或空格。
  • 文档提到的“邮箱”是JSON中的client_email字段，必须填这个值，不能用其他关联邮箱。
    把这两个值准确填入Azure Notification Hubs的FCM V1配置区域，即可解决保存报错问题。

• MAUI端兼容适配
  Azure暂无官方MAUI版Notification Hubs SDK，但可以直接使用Xamarin的Microsoft.Azure.NotificationHubs NuGet包（建议安装最新稳定版）：

  • Android端：在Platforms/Android目录放入Firebase的google-services.json，实现FirebaseMessagingService子类，获取FCM令牌后调用Notification Hubs的注册接口。
  • iOS端：配置APNs证书，实现UNUserNotificationCenterDelegate处理通知权限和令牌获取，同样将令牌注册到Notification Hubs。

• 发送端指定FCM V1协议
  后端发送通知时，必须明确使用FCM V1协议：

  • 若用.NET SDK，创建Notification对象时指定NotificationPlatform.FcmV1，并构造符合FCM V1规范的JSON payload（比如包含message、notification或data字段的结构）。
  • 若用REST API，请求头需指定ServiceBusNotification-Format: fcmv1，并传入符合FCM V1格式的请求体。

2. 关于微软FAQ建议的解读 #

你没有完全误解，但需明确FAQ的适用场景：

• FAQ中的建议是针对Xamarin用户迁移到FCM V1时的指导——由于Xamarin已弃用，且Notification Hubs对Xamarin的FCM V1支持有限，所以建议放弃。但MAUI作为Xamarin的继任者，底层API与Xamarin高度兼容，因此可以通过沿用Xamarin SDK的方式继续使用Notification Hubs。
• 微软给出该建议的核心原因：
  1. Azure Notification Hubs目前没有针对MAUI的官方支持（无专属SDK、文档未更新适配MAUI），属于“兼容可用但非官方推荐”的状态。
  2. FCM V1的集成逻辑比Legacy版本复杂，Notification Hubs的FCM V1支持仍在迭代完善中，可能存在部分边缘场景的兼容性问题。
  3. 微软希望引导用户转向更现代的推送方案，比如直接调用FCM V1/APNs原生API，或使用Azure Communication Services等新服务，但这并不意味着Notification Hubs完全不可用。

补充：旧版FCM API停用后，只要正确配置FCM V1凭证并使用对应协议发送通知，MAUI应用的推送功能不会失效。

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