为何iPhone短时间断网后能接收全部FCM推送，iPad却不行？

核心原因分析 #

iPhone短时间断网后能接收全部通知，并非APNs打破了“离线仅存最后一条”的规则，而是因为：

• 短时间内发送的通知，APNs可能还未完成合并清理，或是设备本地临时缓存机制生效
• iPadOS 17对APNs的消息合并逻辑执行更严格，无论断网时长都会只保留最后一条

针对性解决方法 #

1. 移除contentAvailable配置

你当前代码中设置的setContentAvailable(true)是用于触发后台静默刷新的，APNs会将这类消息归为同优先级任务合并。移除该配置后，通知会被标记为标准用户可见通知，APNs的合并逻辑会更宽松：

protected ApnsConfig getApnsConfig() {
    return ApnsConfig.builder()
        .setAps(Aps.builder()
            .setAlert(ApsAlert.builder()
                .setTitle(title)
                .setBody(body)
                .build())
            .setSound("default")
            .setMutableContent(true)
            // 移除setContentAvailable(true)
            .build())
        .build();
}

2. 为每条通知设置唯一的apns-collapse-id

APNs的合并规则是：同一个collapse-id的通知，离线时仅保留最后一条。如果为每条通知生成唯一的collapse-id，APNs会为每个ID单独保留最后一条消息，离线期间发送的多条不同ID的通知，联网后都会被推送：

protected ApnsConfig getApnsConfig() {
    // 生成唯一ID，比如UUID
    String uniqueCollapseId = UUID.randomUUID().toString();
    return ApnsConfig.builder()
        .putHeader("apns-collapse-id", uniqueCollapseId)
        .setAps(Aps.builder()
            .setAlert(ApsAlert.builder()
                .setTitle(title)
                .setBody(body)
                .build())
            .setSound("default")
            .setMutableContent(true)
            .build())
        .build();
}

3. 检查iPad的系统通知设置

• 确保iPad「设置-通知」中，你的App通知权限完全开启，未开启「静默通知」限制
• 关闭「通知分组」功能，避免系统本地合并通知

4. 调整FCM消息发送策略

• 避免短时间内发送大量重复类型的通知，APNs仍可能合并相似内容的消息
• 使用FCM主题订阅或设备组发送时，确保每条消息的payload有明显差异，触发APNs的独立推送逻辑

补充说明 #

APNs的核心规则仍是离线时仅保留同类型/同collapse-id的最后一条通知，上述方法是通过调整消息标识和配置，让APNs将多条通知识别为独立任务，从而实现联网后全部推送。

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