iOS重启后未启动App时FCM数据消息被取消的问题求助

核心原因 #

从日志中的[pushDisallowed]: Required:0.00, Observed:1.00可以明确：iOS设备重启后、App首次被用户打开前，系统会禁止后台推送唤醒App。这是iOS的安全机制——重启后App处于未激活状态，系统会限制所有后台活动（包括FCM纯数据消息的后台唤醒），直到用户手动启动一次App，系统才会恢复该App的后台推送权限。

另外，纯数据消息完全依赖App的后台处理能力，iOS对这类后台唤醒的限制比带通知体的推送更严格，尤其在App未首次启动的场景下。

修复方案 #

1. 开启正确的iOS后台模式 #

在Expo项目中，必须配置ios.backgroundModes包含remote-notification，告知系统App需要处理远程推送的后台唤醒：
在app.json或app.config.js中添加：

{
  "expo": {
    "ios": {
      "backgroundModes": ["remote-notification"]
    }
  }
}

2. 优化FCM消息的APNs配置 #

当前配置已接近正确，可补充以下优化：

• 保留apns-push-type: background和apns-priority: 5（后台推送必须用优先级5，避免被系统节流）
• 添加mutable-content: 1，允许App在后台处理消息后修改并展示本地通知

修改后的Firebase Admin SDK代码：

Message firebaseMessage = Message.builder()
        .putData("notificationId", notificationId)
        .putData("title", title)
        .putData("body", message)
        .putData("imageUrl", imageUrl)
        .putData("channelImageUrl", channelImageUrl)
        .putData("channelId", "channel-notifications")
        .setApnsConfig(ApnsConfig.builder()
                .setAps(Aps.builder()
                        .setContentAvailable(true)
                        .setMutableContent(true) // 新增字段
                        .build())
                .putHeader("apns-push-type", "background")
                .putHeader("apns-priority", "5")
                .putHeader("apns-topic", "<my-app-bundle-id>")
                .build())
        .setAndroidConfig(AndroidConfig.builder()
                .setPriority(AndroidConfig.Priority.HIGH)
                .build())
        .setToken(recipient)
        .build();

3. 首次启动时重新确认推送权限 #

iOS重启后，用户之前授予的推送权限是持久化的，但系统需要App再次激活权限。在App启动时主动请求权限，确保系统恢复推送能力：

import * as Notifications from 'expo-notifications';

async function activatePushPermissions() {
  const { status: existingStatus } = await Notifications.getPermissionsAsync();
  let finalStatus = existingStatus;
  if (existingStatus !== 'granted') {
    const { status } = await Notifications.requestPermissionsAsync();
    finalStatus = status;
  }
  if (finalStatus !== 'granted') {
    alert('无法获取推送权限，将无法接收通知');
    return;
  }
  // 后续可在此获取FCM令牌等操作
}

// 在App根组件的useEffect中调用
useEffect(() => {
  activatePushPermissions();
}, []);

4. 备选：改用“通知消息+数据负载”模式 #

如果必须在重启后未打开App时展示通知，可以放弃纯数据消息，改用FCM通知消息+数据负载的形式。这种情况下，iOS系统会直接处理通知并展示，无需App后台唤醒，用户点击通知后再触发App处理数据：

Message firebaseMessage = Message.builder()
        .setNotification(Notification.builder()
                .setTitle(title)
                .setBody(message)
                .build())
        .putData("notificationId", notificationId)
        .putData("imageUrl", imageUrl)
        .putData("channelImageUrl", channelImageUrl)
        .putData("channelId", "channel-notifications")
        .setApnsConfig(ApnsConfig.builder()
                .setAps(Aps.builder()
                        .setContentAvailable(true)
                        .build())
                .putHeader("apns-push-type", "alert") // 通知消息用alert类型
                .putHeader("apns-priority", "10") // 通知消息用高优先级
                .putHeader("apns-topic", "<my-app-bundle-id>")
                .build())
        .setAndroidConfig(AndroidConfig.builder()
                .setPriority(AndroidConfig.Priority.HIGH)
                .build())
        .setToken(recipient)
        .build();

关键说明 #

iOS的pushDisallowed限制是系统级安全规则，无法完全绕过——重启后必须用户手动打开一次App，系统才会允许后台推送唤醒App处理纯数据消息。上述方案均是在系统规则内优化体验，或通过通知消息的方式绕过后台唤醒限制。

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