Firebase Cloud Messaging通过Python/Django发送指定设备消息失败求助

根据你的描述，Firebase控制台推送正常但Django后端发送无响应（返回成功但设备收不到），可以从以下几个方向逐一排查：

1. 验证Firebase Admin SDK的配置与环境匹配 #

• 确认后端使用的Firebase服务账号密钥属于当前开发项目，初始化Admin SDK时没有指定错误环境（默认是生产环境，开发设备debug模式下无需额外切换，但需确保密钥对应正确项目）。
• 检查SDK初始化代码是否正确：

  import firebase_admin
  from firebase_admin import credentials, messaging
  
  cred = credentials.Certificate("path/to/serviceAccountKey.json")
  firebase_admin.initialize_app(cred)
  

  确保serviceAccountKey.json是从当前Firebase项目设置 -> 服务账号页面下载的。

2. 调整消息Payload的平台配置 #

控制台发送的通知会自动填充部分平台参数，但后端代码需要显式配置才能确保通知在后台/锁屏状态下正常显示：

• Android端：添加高优先级和通知渠道（Android 8.0+强制要求）
  修改Python代码中的Message对象：

  message = Message(
      notification=Notification(
          title='New Product Added',
          body=f'A new product called {validated_data["name"]} has been added to your account.',
      ),
      token=registration_token[0],
      android=AndroidConfig(
          priority='high',  # 确保后台设备能收到通知
          notification=AndroidNotification(
              channel_id='default_notification_channel'  # 需与Flutter端创建的渠道ID一致
          )
      )
  )
  

• iOS端：添加APNs优先级配置（提升后台送达率）

  message = Message(
      # ... 其他配置
      apns=ApnsConfig(
          headers={'apns-priority': '10'},
          payload=ApsPayload(
              sound='default'
          )
      )
  )
  

3. 确认注册令牌的有效性与同步 #

• 验证令牌是否未过期/失效：
  用Admin SDK的messaging.get_token()方法校验：

  try:
      token_info = messaging.get_token(registration_token[0])
      print("令牌有效，所属项目:", token_info.project_id)
  except messaging.InvalidTokenError:
      print("令牌无效，请更新前端同步的令牌")
  

• Flutter端需处理令牌刷新：Firebase令牌会定期更新，前端要监听令牌变化并同步到后端：

  FirebaseMessaging.instance.onTokenRefresh.listen((newToken) {
    // 将新令牌发送到后端更新存储
  });
  

4. 检查Flutter端的消息接收配置 #

确保Flutter端正确处理前台/后台消息：

• 前台消息监听：

  FirebaseMessaging.onMessage.listen((RemoteMessage message) {
    print('收到前台通知: ${message.notification?.title}');
    // 可手动调用本地通知插件显示通知
  });
  

• 后台消息处理：必须配置全局后台回调（需定义在main()函数外）：

  @pragma('vm:entry-point')
  Future<void> firebaseMessagingBackgroundHandler(RemoteMessage message) async {
    await Firebase.initializeApp();
    print('收到后台通知: ${message.notification?.title}');
  }
  
  void main() {
    FirebaseMessaging.onBackgroundMessage(firebaseMessagingBackgroundHandler);
    runApp(MyApp());
  }
  

• 权限申请：Android 13+需申请POST_NOTIFICATIONS权限，iOS需请求通知权限：

  void requestNotificationPermissions() async {
    NotificationSettings settings = await FirebaseMessaging.instance.requestPermission(
      alert: true,
      badge: true,
      sound: true,
    );
    print('权限状态: ${settings.authorizationStatus}');
  }
  

• Android通知渠道创建：初始化时创建与后端匹配的通知渠道：

  void createNotificationChannel() async {
    if (Platform.isAndroid) {
      AndroidNotificationChannel channel = AndroidNotificationChannel(
        'default_notification_channel',
        '默认通知渠道',
        importance: Importance.high,
        description: '用于接收应用通知',
      );
      await FirebaseMessaging.instance.setForegroundNotificationPresentationOptions(
        alert: true,
        badge: true,
        sound: true,
      );
      final FlutterLocalNotificationsPlugin flutterLocalNotificationsPlugin = FlutterLocalNotificationsPlugin();
      await flutterLocalNotificationsPlugin.resolvePlatformSpecificImplementation<AndroidFlutterLocalNotificationsPlugin>()?.createNotificationChannel(channel);
    }
  }
  

5. 查看FCM官方日志定位问题 #

• 登录Firebase控制台，进入云消息传递 -> 消息历史，用后端返回的消息ID搜索，查看消息的送达状态（如"已送达""失败""已取消"）。
• 进入云消息传递 -> 报告，查看近期推送的送达率、失败原因统计，常见原因包括：令牌无效、设备离线、权限不足、平台配置错误等。

6. 开发环境特殊检查 #

• Android debug模式：确保Firebase控制台项目设置 -> 应用中添加了debug版本的SHA-1指纹（令牌与签名绑定，debug令牌需对应指纹才能正常接收Admin SDK推送）。
• iOS开发模式：确认Firebase项目中配置了APNs开发证书，且Xcode运行目标为开发环境。

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