Xcode中Notification Service Extension配置无效问题求助

明确说明：不需要使用MORichNotification这类第三方工具，原生Extension完全可以实现通知修改功能，以下是你可能忽略的操作细节：

1. 部署目标与配置文件检查 #

你将Extension部署目标设为10.3、主项目设为11.0的配置本身没问题，但需确认Extension的Info.plist配置：

• 必须存在NSExtension字典，且NSExtensionAttributes下包含UNNotificationExtensionCategory键（即使没有自定义通知分类，也不能缺失该键，可留空值）。
• 确保NSExtensionPrincipalClass指向正确的Extension类（默认生成的是NotificationService，不要修改类名后忘记更新这里）。

2. FCM Payload的关键细节 #

你的当前Payload存在两处可能的问题：

• to字段里的前置空格要去掉，改为"device token/ firebase topic"，格式错误会导致推送无法正确送达设备。
• 若通过FCM控制台发送通知，需手动勾选「允许修改内容」选项（对应mutable_content: true）；服务器发送时要确保mutable_content是布尔值而非字符串（你的JSON写法是正确的，避免写成"true"）。

3. Extension代码逻辑校验 #

创建Extension后，默认生成的代码必须保证核心逻辑正确：

• 一定要调用contentHandler传递修改后的通知内容，否则通知会被丢弃。示例正确逻辑：

  override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
      self.contentHandler = contentHandler
      bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
      
      if let bestAttemptContent = bestAttemptContent {
          // 此处添加自定义修改逻辑，比如修改标题、加载附件
          bestAttemptContent.title = "\(bestAttemptContent.title) [已修改]"
          contentHandler(bestAttemptContent)
      }
  }
  

• 若代码中遗漏contentHandler调用，或提前返回未执行该方法，Extension不会生效。

4. 签名与运行权限确认 #

• 确保Extension的签名配置和主项目完全一致，使用同一开发者团队，且Provisioning Profile包含推送权限（你已在Extension target启用推送，需确认配置文件同步更新）。
• 运行时，Extension依赖主App，需确保主App已安装且用户已授权推送权限；选中Extension target运行时，Xcode会自动安装主App和Extension，但需确认主App的推送权限弹窗已被用户允许。

5. 测试场景的正确姿势 #

• 仅当App处于后台或锁屏状态时，才会触发Notification Service Extension；前台收到的通知需通过UNUserNotificationCenterDelegate处理，不会走Extension逻辑。
• 必须使用真实设备测试，模拟器无法接收APNs推送，自然无法触发Extension。

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