Ionic 5+Capacitor 3安卓端FCM推送收不到问题求助

以下是针对你遇到的「能获取FCM Token但无法接收任何推送」问题的排查方向：

1. 确认FCM消息类型与插件监听逻辑匹配 #

FCM分为通知消息和数据消息，两者在不同应用状态下的处理逻辑不同：

• 若发送纯通知消息：应用前台时会触发pushNotificationReceived监听；后台/关闭状态下，系统会直接展示通知，但不会触发pushNotificationReceived（仅点击通知时触发pushNotificationActionPerformed）。
• 若发送数据消息或混合消息（同时包含通知和数据字段）：无论应用状态如何，都需要自行处理通知展示逻辑，Capacitor插件不会自动弹出通知。

测试时建议发送混合消息，确保能在日志中看到pushNotificationReceived的输出，验证监听是否正常工作。

2. 检查安卓端谷歌服务配置细节 #

即使已放置google-services.json，仍需确认以下点：

• google-services.json中的package_name需与安卓项目build.gradle中的applicationId完全一致（包括大小写）。
• 确认安卓根目录build.gradle已引入谷歌服务插件：

  buildscript {
    dependencies {
      classpath 'com.google.gms:google-services:4.3.10' // 版本需匹配Capacitor3要求
    }
  }
  

• 确认安卓app/build.gradle末尾已应用插件：

  apply plugin: 'com.google.gms.google-services'
  

3. 安卓8.0+需配置通知通道 #

安卓8.0（API 26）及以上系统要求所有通知必须关联到通知通道，否则无法显示。Capacitor PushNotifications插件默认不会自动创建通道，需手动添加：
可以通过Capacitor的Notifications插件创建通道，示例代码：

import { Notifications } from '@capacitor/notifications';

async createNotificationChannel() {
  await Notifications.createChannel({
    id: 'default',
    name: 'Default Channel',
    description: 'Default notifications channel',
    sound: 'default',
    importance: 5,
  });
}

调用此方法后，发送推送时需指定channel_id为你创建的通道ID（如上述示例的default）。

4. 验证插件版本兼容性 #

确保@capacitor/push-notifications版本与Capacitor3完全兼容，Capacitor3对应的插件版本应为^3.x.x。可以查看package.json中的版本号，若版本不匹配，执行以下命令更新：

npm install @capacitor/push-notifications@3.x.x
npx cap sync android

5. 检查Firebase测试推送的配置 #

• 确认测试时使用的是设备注册的FCM Token，而非其他令牌（如APNs令牌），且Token无复制错误。
• 在Firebase控制台发送测试消息时，确保选择了安卓平台，并正确填写Token。

6. 代码逻辑与初始化检查 #

• 检查initPush()方法是否在应用启动时被调用（例如在AppComponent的ngOnInit中调用），确保推送监听逻辑被正确初始化。
• 修复代码中的语法错误：this.notification state.setToken(token.value);中的空格应为this.notificationState.setToken(token.value);，避免状态管理异常。

7. 安卓设备的电池优化限制 #

部分国产安卓设备（如小米、华为、OPPO等）的电池优化策略会限制后台应用接收推送，需：

• 将应用加入电池优化白名单，关闭应用的电池优化。
• 允许应用的后台活动权限，确保应用在后台能接收FCM消息。

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