Android Firebase 推送问题排查指南

当 Firebase 推送通知无法到达 Android 设备时，可能是由多种原因导致的。以下是一些常见问题和解决方案：

常见原因及解决方案

1. 设备未正确注册

• 问题：设备未成功注册到 Firebase Cloud Messaging (FCM)

• 解决方案：

  • 确保应用已正确集成 FCM SDK

  • 检查是否成功获取了 FCM 令牌 (token)

  • 在应用启动时调用 FirebaseMessaging.getInstance().getToken() 获取最新令牌

2. 服务器端配置问题

• 问题：服务器发送通知的配置不正确

• 解决方案：

  • 确保使用正确的服务器密钥或 Firebase 项目凭据

  • 检查发送的 JSON 格式是否正确

  • 验证目标设备令牌是否最新

3. 应用权限问题

• 问题：缺少必要的权限

• 解决方案：

  • 在 AndroidManifest.xml 中添加：

    xml

    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.WAKE_LOCK" />
    <uses-permission android:name="com.google.android.c2dm.permission.RECEIVE" />

4. 后台限制

• 问题：Android 系统对后台服务的限制

• 解决方案：

  • 对于 Android 8.0+，需要创建通知渠道

  • 确保应用没有被用户或系统强制停止

5. Firebase 服务未启用

• 问题：Firebase 项目中未启用 Cloud Messaging

• 解决方案：

  • 登录 Firebase 控制台

  • 进入项目设置 → Cloud Messaging

  • 确保服务已启用

调试步骤

1. 检查令牌获取：

   java

   FirebaseMessaging.getInstance().getToken().addOnCompleteListener(task -> {if (!task.isSuccessful()) {Log.w("FCM", "Fetching FCM registration token failed", task.getException());return;}String token = task.getResult();Log.d("FCM", "Token: " + token);});

2. 验证服务器响应：

   • 发送测试消息后检查服务器响应

   • 成功响应应包含 message_id

   • 失败响应会包含错误信息

3. 检查日志：

   • 查看 Android Studio 的 Logcat 输出

   • 过滤 "Firebase" 或 "FCM" 标签

4. 测试直接发送：

   • 使用 Firebase 控制台的"发送测试消息"功能

   • 输入设备令牌进行测试

其他注意事项

• 确保设备有网络连接

• 检查设备是否处于省电模式（可能限制后台网络）

• 对于中国区设备，可能需要检查 Google Play 服务可用性

• 如果是华为设备，可能需要集成华为推送服务（HMS）

如果以上步骤仍无法解决问题，建议检查 Firebase 的官方文档或提供更具体的错误信息以便进一步排查。