React Native iOS修改远程通知内容：Notification Service Extension失效求助

针对你在React Native iOS项目中添加Notification Service Extension后，didReceiveNotificationRequest:withContentHandler:方法未被调用的问题，结合你的Demo可正常工作的情况，按以下步骤排查修复：

1. 确认推送Payload包含mutable-content: 1 #

Notification Service Extension仅会处理带有mutable-content: 1字段的远程推送，这是触发扩展的核心前提。
确保后端下发的推送Payload结构类似：

{
  "aps": {
    "alert": {
      "title": "测试通知",
      "body": "原始内容"
    },
    "sound": "default",
    "mutable-content": 1
  }
}

注意：mutable-content是数字1，不是字符串"1"

2. 检查Extension的Target配置 #

• Bundle ID规则：Extension的Bundle ID必须是主App Bundle ID的后缀形式（例如主App为com.your.app，Extension需设为com.your.app.NotificationService）
• 签名配置：Extension的签名证书、Provisioning Profile必须和主App保持一致（开发/生产环境对应）
• Info.plist验证：打开Extension的Info.plist，确认以下字段：
  • NSExtension -> NSExtensionPointIdentifier值为com.apple.usernotifications.service
  • NSExtension -> NSExtensionPrincipalClass值为你的扩展类名（默认是NotificationService）

3. 排查React Native推送库的冲突 #

你使用的react-native-push-notification和@react-native-community/push-notification-ios可能存在通知处理的拦截：

• 确保react-native-push-notification的iOS配置没有覆盖UNUserNotificationCenter的代理逻辑
• 检查AppDelegate中是否有其他代码修改了UNUserNotificationCenter.currentNotificationCenter().delegate，避免覆盖你设置的self

4. 验证Extension代码逻辑 #

确保Extension的didReceiveNotificationRequest:withContentHandler:方法正确实现，且必须调用contentHandler：

- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
    self.contentHandler = contentHandler;
    self.bestAttemptContent = [request.content mutableCopy];
    
    // 在这里修改通知内容，例如替换body
    self.bestAttemptContent.body = [NSString stringWithFormat:@"修改后的内容: %@", self.bestAttemptContent.body];
    
    // 必须调用contentHandler返回修改后的内容
    self.contentHandler(self.bestAttemptContent);
}

// 超时处理，确保即使超时也返回内容
- (void)serviceExtensionTimeWillExpire {
    self.contentHandler(self.bestAttemptContent);
}

5. 测试场景验证 #

• 仅远程推送会触发Extension，本地推送不会触发
• 测试时确保设备和推送环境匹配（开发环境用APNs开发服务器，生产环境用生产服务器）
• 重启设备后再测试，避免缓存导致的异常

内容的提问来源于stack exchange，提问作者shraddha k vaishanani