iOS端Firebase推送通知调试：测试消息无法接收问题排查

我在iOS设备上调试Firebase推送通知功能，已通过Angular获取令牌并发送至Python后端存入数据库。目前遇到的问题：在Firebase控制台创建推送活动时，设备可正常接收通知；但使用「发送测试消息」功能，输入数据库中的令牌后却无响应，怀疑令牌获取方式或令牌本身存在问题。

相关代码 #

登录表单中获取令牌的逻辑：

import { PushNotifications, Token } from '@capacitor/push-notifications';
import { Capacitor } from '@capacitor/core';

// ...

onSubmit(): void {
  const { username, password } = this.form;
  const isPushNotificationsAvailable = Capacitor.isPluginAvailable('PushNotifications');
   
  if (isPushNotificationsAvailable) {
    PushNotifications.requestPermissions().then(result => {
      if (result.receive === 'granted') {
        // 向苹果/谷歌注册以接收推送
        PushNotifications.register();
      } else {
        this.tokenvalue = ""
        this.LogOn(username, password, this.tokenvalue)
      }
    });
    PushNotifications.addListener('registration', (token: Token) => {
      console.log('Push registration success, token: ' + token.value);
      this.tokenvalue = token.value
      this.LogOn(username, password, this.tokenvalue)
    });    
  } else {
    this.tokenvalue = ""
    this.LogOn(username, password, this.tokenvalue)
  }
}

当前获取到的令牌格式为：5BA41427198D463847....................80585EAFC3C2670226E22C082A（共64个字符）

问题分析与解决建议 #

• 令牌类型混淆：你拿到的64字符令牌是APNS设备令牌，而非Firebase测试消息所需的FCM注册令牌。Firebase控制台的推送活动是通过用户/设备组维度下发，能兼容APNS令牌；但「发送测试消息」功能仅支持FCM注册令牌，用APNS令牌自然无法触发通知。
• 代码逻辑冗余：每次登录都添加registration监听器，可能导致重复注册，引发多次调用LogOn甚至令牌覆盖问题。建议将监听器添加到组件初始化阶段（如ngOnInit），而非登录提交方法内。
• 正确获取FCM注册令牌：在iOS上，需将Capacitor获取的APNS令牌传给Firebase换取FCM令牌，可借助Firebase JS SDK实现：

  import { getMessaging, getToken } from "firebase/messaging";
  
  // 在组件初始化时添加监听器
  ngOnInit(): void {
    const isPushNotificationsAvailable = Capacitor.isPluginAvailable('PushNotifications');
    if (isPushNotificationsAvailable) {
      PushNotifications.addListener('registration', async (token: Token) => {
        const messaging = getMessaging();
        // 传入APNS令牌获取FCM注册令牌
        const fcmToken = await getToken(messaging, {
          vapidKey: '你的VAPID密钥',
          ios: {
            appId: '你的iOS App ID',
            apnsToken: token.value
          }
        });
        console.log('FCM注册令牌:', fcmToken);
        this.tokenvalue = fcmToken;
      });
    }
  }
  
  // 登录方法中仅处理权限请求和注册
  onSubmit(): void {
    const { username, password } = this.form;
    const isPushNotificationsAvailable = Capacitor.isPluginAvailable('PushNotifications');
     
    if (isPushNotificationsAvailable) {
      PushNotifications.requestPermissions().then(result => {
        if (result.receive === 'granted') {
          PushNotifications.register();
          // 等待监听器获取到FCM令牌后再调用LogOn，可通过Promise或变量判断
        } else {
          this.tokenvalue = ""
          this.LogOn(username, password, this.tokenvalue)
        }
      });
    } else {
      this.tokenvalue = ""
      this.LogOn(username, password, this.tokenvalue)
    }
  }
  

• 验证存储令牌类型：检查后端数据库中存储的是否为FCM注册令牌（格式通常为eKxxx...:APA91bxxx...的长字符串），确保不是APNS令牌。
• 测试流程校验：使用正确的FCM注册令牌测试，同时确认iOS设备通知权限完全开启，Firebase控制台项目与App的Bundle ID绑定一致。

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