Firebase推送通知Crashlytics报空指针异常求助

看起来你遇到了一个典型的「本地测试正常但生产环境批量崩溃」的问题——明明推送参数里的body不为空，却有大量用户触发remoteMessage.getNotification().getBody()的空指针异常。结合FCM的工作机制和生产环境的复杂场景，我整理了几个最可能的原因和对应的解决办法：

一、存在未携带notification字段的推送消息 #

你当前提供的推送参数确实包含notification字段，但生产环境中很可能存在纯数据消息（仅含data字段）或者推送过程中notification字段丢失的情况：

• FCM分两种消息类型：「通知消息」（带notification字段）和「数据消息」（仅带data字段）。纯数据消息会直接触发onMessageReceived，但remoteMessage.getNotification()会返回null；
• 可能存在部分推送调用错误，比如误发了纯数据消息，或者推送接口的notification字段因参数拼接错误被遗漏。

解决办法 #

在调用getBody()前必须先判断notification是否为null，同时兼容数据消息的场景：

public void onMessageReceived(RemoteMessage remoteMessage) {
    String messagetext = null;
    
    // 优先从notification字段获取内容
    if (remoteMessage.getNotification() != null) {
        messagetext = remoteMessage.getNotification().getBody();
    } else {
        // 如果是数据消息，从data字段提取（根据你的实际数据结构调整key）
        messagetext = remoteMessage.getData().get("body");
        // 若不需要处理纯数据消息，可直接return
        // return;
    }
    
    // 确保消息内容非空再发送通知
    if (messagetext != null) {
        sendNotification(messagetext);
    }
}

二、FCM消息分发过程中的异常解析 #

极少数情况下，FCM可能因为设备网络波动、缓存冲突或者服务器端的临时异常，导致消息的notification字段被截断，设备端解析后得到null值。这种情况在大用户量场景下偶发，很难在本地复现。

解决办法 #

除了空判断，建议加入日志记录，方便后续排查：

public void onMessageReceived(RemoteMessage remoteMessage) {
    // 将完整消息内容记录到Crashlytics，方便崩溃时回溯
    FirebaseCrashlytics.getInstance().log("FCM Received Message: " + remoteMessage.toString());
    
    String messagetext = null;
    if (remoteMessage.getNotification() != null) {
        messagetext = remoteMessage.getNotification().getBody();
    } else {
        messagetext = remoteMessage.getData().get("body");
    }
    
    if (messagetext != null) {
        sendNotification(messagetext);
    } else {
        // 记录异常到Crashlytics，追踪无内容的消息
        FirebaseCrashlytics.getInstance().recordException(
            new IllegalArgumentException("No valid message body found in FCM message")
        );
    }
}

三、旧SDK或设备ROM的兼容性问题 #

某些旧版本的Firebase Messaging SDK在Android 6.0以下系统，或者小米、华为等厂商的定制ROM上，可能存在notification字段解析的bug，导致remoteMessage.getNotification()返回null。

解决办法 #

1. 升级你的Firebase Messaging SDK到最新稳定版；
2. 尝试在模拟器中模拟旧Android版本或厂商ROM，验证是否存在兼容性问题。

总结 #

核心问题是你的代码默认假设remoteMessage.getNotification()永远不为null，但生产环境的消息结构可能和测试场景不一致。只要加上严格的空判断，就能彻底解决这个空指针崩溃。

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