FlutterFire Firebase Messaging安卓正常iOS报无效参数错误求助

1. 确认iOS通知权限已正确获取 #

iOS必须获得用户授权才能生成有效FCM令牌，在调用getToken()前需先请求权限：

// 请求通知权限
final settings = await FirebaseMessaging.instance.requestPermission(
  alert: true,
  badge: true,
  sound: true,
);

// 仅当用户授权后获取并保存令牌
if (settings.authorizationStatus == AuthorizationStatus.authorized) {
  final token = await FirebaseMessaging.instance.getToken();
  // 将令牌保存至数据库
}

未授权时getToken()可能返回空值或无效格式，直接保存会触发后端报错。

2. 验证iOS端FCM配置完整性 #

• 确认Firebase控制台已上传APNs认证密钥(.p8)，且密钥关联的Team ID、Bundle ID与Xcode项目完全匹配。
• 检查iOS项目Info.plist配置：
  添加后台通知支持：

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

  确保FirebaseAppDelegateProxyEnabled设置为YES（默认已配置，勿随意修改）。

3. 校验令牌格式与有效性 #

• 打印获取到的iOS令牌，确认格式为类似APA91bHun4MxP5egoKMwt2KZFBaFUH-1RYqx...的字符串（长度约150-200字符），若为空或格式异常，说明令牌生成失败。
• 用Firebase控制台的Cloud Messaging测试功能直接向该令牌发测试通知：
  若控制台返回"Invalid registration token"，则令牌确实无效；若发送成功，问题出在后端请求参数。

4. 检查后端FCM请求参数 #

后端调用FCM API时需注意iOS专属要求：

• 请求头必须包含Authorization: key=你的FCM服务器密钥和Content-Type: application/json。
• 请求体需符合规范，示例：

  {
    "to": "iOS设备令牌",
    "notification": {
      "title": "测试通知",
      "body": "测试内容"
    },
    "apns": {
      "payload": {
        "aps": {
          "content-available": 1
        }
      }
    }
  }
  

  避免遗漏apns字段或出现参数拼写错误。

5. 适配依赖版本兼容性 #

Flutter 3.0.0与firebase_messaging: ^14.1.0可能存在适配问题，建议升级至兼容版本：
修改pubspec.yaml：

firebase_core: ^2.15.0
firebase_messaging: ^14.6.0

执行flutter pub get后重新编译iOS项目。

6. 监听令牌刷新事件 #

iOS令牌可能因APP重装、系统更新等原因变更，需同步更新数据库：

FirebaseMessaging.instance.onTokenRefresh.listen((newToken) {
  // 将新令牌更新至数据库
});

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