使用Capacitor与Firebase的iOS设备无法接收推送通知求助

以下是针对你遇到的问题的逐一排查点和解决方法：

一、核心配置细节验证 #

• GoogleService-Info.plist 有效性
  不要仅将文件放入iOS项目根目录，需在Xcode中右键该文件，确认Target Membership已勾选对应App目标，确保Xcode能正确加载配置。
• APNs 证书匹配性
  • 开发模式对应Sandbox证书，生产模式（Ad Hoc/App Store）对应Production证书，测试环境必须与证书类型一致。
  • 证书的Bundle ID需与项目Bundle ID完全一致（包括大小写），且证书未过期、生成账号与项目签名账号一致。
• 版本兼容性
  当前使用的Capacitor版本组合兼容，但可尝试更新@capacitor/push-notifications至5.x最新稳定版，修复潜在已知bug。

二、代码逻辑检查 #

• 完整权限请求流程
  确认用户已授予全部推送相关权限（alert、sound、badge），可在权限请求后打印状态验证：

  import { PushNotifications } from '@capacitor/push-notifications';
  
  async function verifyNotificationPermissions() {
    const permStatus = await PushNotifications.checkPermissions();
    console.log('权限状态:', permStatus);
    // 需确保alert、sound、badge均为'granted'
  }
  

• 通知事件监听完整性
  覆盖前台、后台、应用杀死状态的通知监听，避免遗漏接收逻辑：

  // 前台接收通知
  PushNotifications.addListener('pushNotificationReceived', (notif) => {
    console.log('前台收到通知:', notif);
  });
  
  // 点击通知唤醒应用
  PushNotifications.addListener('pushNotificationActionPerformed', (action) => {
    console.log('通知操作触发:', action);
  });
  

• FCM令牌获取时机
  确保令牌在权限授予后获取，且正确上传至FCM控制台/你的服务器：

  PushNotifications.addListener('registration', (tokenData) => {
    console.log('FCM令牌:', tokenData.value);
    // 在此处上传令牌至服务器
  });
  

三、FCM控制台测试注意事项 #

• 环境选择正确
  真机开发测试选「开发环境」，生产包测试选「生产环境」；在高级选项中设置apns-priority: 10（确保立即送达）、apns-push-type: alert。
• 模拟器限制
  iOS模拟器仅Apple Silicon机型且登录Apple ID后才支持推送，优先使用真机测试。

四、Xcode项目配置检查 #

• Capabilities 配置
  进入App目标的Signing & Capabilities：
  • 确认已添加Push Notifications能力。
  • 开启Background Modes并勾选Remote notifications，保证后台接收推送。
• Info.plist 配置
  确保UIBackgroundModes包含remote-notification，FirebaseAppDelegateProxyEnabled设置为YES（默认值，勿随意修改）。

五、日志排查 #

连接真机至Xcode，查看控制台日志：

• 搜索FIRMessaging，排查APNs令牌获取失败信息（如Failed to fetch APNS token）。
• 搜索APNs，查看推送是否到达设备但被拦截。
• 确认GoogleService-Info.plist是否被正确加载。

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