Xamarin迁移Flutter后Android推送报错：注册句柄无效

核心排查与解决方向 #

1. 验证FCM推送通道有效性 #

• 调用Firebase Messaging的getToken()获取最新Token，确保无额外字符（空格、换行等），直接用该Token在Firebase控制台发送测试推送，确认Token本身可正常接收推送。若Firebase能推送到设备，说明Token有效，问题出在Notification Hub注册环节
• 注意：Flutter获取的FCM Token为纯字符串，无需编码或转义

2. 核对Notification Hub注册参数 #

• 确认注册时指定的平台类型为Android，避免与Xamarin项目的平台标识（如Gcm）混淆
• 检查deviceId是否重复：同一设备多次注册未清理旧记录会导致Hub内存在无效条目，注册前先调用注销接口清除旧记录
• 标签格式需合规：不能包含空格、逗号及特殊字符，确保符合Azure Notification Hub规范

3. 检查Android项目配置细节 #

• 确认google-services.json的包名与Flutter Android项目的applicationId完全一致，大小写差异会导致FCM鉴权失败
• 验证AndroidManifest.xml中的FCM服务配置是否正确：

  <service
      android:name=".MyFirebaseMessagingService"
      android:exported="false">
      <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT" />
      </intent-filter>
  </service>
  

• 确保Firebase Messaging依赖版本与google-services插件版本兼容，版本不匹配可能引发Token获取异常

4. 校验注册请求逻辑 #

• 对比Flutter与Xamarin的注册请求参数：
  • 确认请求头Content-Type为application/json
  • 检查注册JSON结构中pushChannel字段直接填入FCM Token，无嵌套或额外包装，示例正确结构：

    {
      "platform": "android",
      "pushChannel": "FCM_TOKEN_HERE",
      "tags": ["tag1", "tag2"],
      "deviceId": "UNIQUE_DEVICE_ID"
    }
    

• 查看Notification Hub注册列表，核对对应设备的PushChannel字段与获取的FCM Token是否完全一致

快速验证流程 #

1. 用Firebase控制台给当前设备的FCM Token发推送，确认设备可接收
2. 清理Notification Hub中该设备的所有旧注册记录
3. 重新获取Token并发起注册，注册成功后立即在Hub发送测试推送
4. 若仍报错，抓取完整注册请求参数，与Xamarin的注册请求逐字段对比

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