Flutter集成Firebase Messaging订阅主题时遇token缺失错误

错误日志 #

FLTFirebaseMessaging: An error occurred while calling method Messaging#subscribeToTopic, errorOrNil => {
    NSLocalizedFailureReason = "Invalid registration response :'Error=INVALID_PARAMETERS'. It is missing 'token' field.";
}
flutter: subscription error: [firebase_messaging/unknown] An unknown error has occurred.

问题代码 #

Future<void> requestMessagingPermission() async {
  FirebaseMessaging messaging = FirebaseMessaging.instance;

  NotificationSettings settings = await messaging.requestPermission(
    alert: true,
    announcement: false,
    badge: true,
    carPlay: false,
    criticalAlert: false,
    provisional: false,
    sound: true,
  );

  print('User granted permission: ${settings.authorizationStatus}');
  if (settings.authorizationStatus == AuthorizationStatus.authorized) {
    print('User granted notifiactions permission');
    messaging.getToken().then((token) async {
      print('Messaging token: $token');

      //configure notification topics
      //gets a list of strings (topic names) from provider and loops through them to subscribe to them all

      GlobalProvider provider = context.read<GlobalProvider>();
      if (provider.notificationTopicsSet == false) {
        //subscribe to topics
        for (var topic in provider.notificationTopics) {
          print('topic subscribing... $topic');
          try {
            await messaging.subscribeToTopic(topic).then((value) => print('topic subscribed: $topic'));
          } catch (e) {
            print('subscription error: $e');
          }
        }
      }
    });
  }
}

排查与解决步骤 #

• 确认token有效性：虽然代码打印了token，但要确保getToken()返回的不是null或空字符串。权限刚授予时，token可能因设备/网络问题未生成完成，建议增加非空判断，避免空token触发订阅逻辑：

  final token = await messaging.getToken();
  if (token == null) {
    print('Failed to retrieve messaging token');
    return;
  }
  

• 统一异步写法：避免混合使用async/await和then，这种写法可能导致上下文异常，改用全await写法确保token完全获取后再执行订阅：

  if (settings.authorizationStatus == AuthorizationStatus.authorized) {
    print('User granted notifiactions permission');
    final token = await messaging.getToken();
    if (token == null) {
      print('Failed to get messaging token');
      return;
    }
    print('Messaging token: $token');
  
    GlobalProvider provider = context.read<GlobalProvider>();
    if (!provider.notificationTopicsSet) {
      for (var topic in provider.notificationTopics) {
        print('topic subscribing... $topic');
        try {
          await messaging.subscribeToTopic(topic);
          print('topic subscribed: $topic');
        } catch (e) {
          print('subscription error: $e');
        }
      }
    }
  }
  

• 检查Firebase初始化时机：确保Firebase在App启动时完成初始化，在main()方法中添加初始化逻辑：

  void main() async {
    WidgetsFlutterBinding.ensureInitialized();
    await Firebase.initializeApp();
    runApp(MyApp());
  }
  

• iOS端额外配置检查：

  • 确认Info.plist中APNs环境配置正确（开发/生产环境对应）；
  • 权限授予后，APNs token可能未同步到Firebase，可尝试重启设备或卸载重装App后测试。

• 验证主题名称合法性：主题名称只能包含字母、数字、连字符、下划线、点号，无空格或特殊字符，长度不超过256字符，不符合规范也可能触发异常。

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