Flutter iOS调用FirebaseMessaging.getToken返回firebase_messaging/unknown错误

问题原因分析 #

你遇到的Too many server requests报错并非实际触发了请求频率限制，结合你用户量不足10人的情况，大概率是以下几种原因导致：

• 低版本firebase_messaging的已知bug：你使用的^10.0.9属于较旧版本，该版本存在未正确处理APNs/FCM配置校验失败时的错误返回，会误报请求超限
• Flutter版本过旧：你使用的是2021年的Flutter master预览版（2.3.0-17.0.pre.121），与firebase依赖存在兼容性问题
• Firebase项目配置异常：iOS端的APNs证书/密钥配置错误、Android端的google-services.json配置不匹配，Firebase服务器拒绝请求时会返回该模糊错误
• 开发环境请求缓存异常：调试阶段反复调用getToken触发本地缓存异常，被Firebase服务器判定为异常请求

修复步骤 #

1. 优先升级依赖版本
   先把Flutter切换到3.10+稳定版，再把pubspec.yaml中的firebase_messaging升级到当前稳定版，同步升级所有firebase相关依赖到兼容版本：

   firebase_messaging: ^14.7.10 # 可替换为当前最新稳定版
   

   升级后执行flutter clean删除缓存，重新编译运行测试。

2. 校验Firebase项目配置

   • iOS端：确认Firebase控制台已上传正确的APNs认证密钥/推送证书，Bundle ID与控制台配置完全一致，Xcode中Signing & Capabilities已添加Push Notifications和Background Modes（勾选Remote notifications）
   • Android端：确认google-services.json是从当前使用的Firebase项目下载，包名与控制台配置匹配，已在Firebase控制台添加SHA-1/SHA-256签名指纹

3. 优化getToken调用逻辑
   避免每次启动/进注册页重复调用getToken，增加异常捕获和退避重试机制：

   String? fcmToken;
   try {
     fcmToken = await FirebaseMessaging.instance.getToken();
   } catch(e) {
     // 触发指数退避重试，最多重试3次
     for(int i=1; i<=3; i++) {
       await Future.delayed(Duration(seconds: i*2));
       try {
         fcmToken = await FirebaseMessaging.instance.getToken();
         break;
       } catch(retryE) {
         if(i == 3) rethrow;
       }
     }
   }
   

4. 如果以上步骤都无效
   前往Firebase控制台的「Cloud Messaging」设置页，检查项目是否有配额超限、权限异常提示，确认服务状态正常后，删除原有服务账号密钥重新生成，替换本地配置文件后重新测试。

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