Notification Service Extension无法修改通知问题排查求助

以下是可能导致你看不到[modified]文本的几个常见原因及排查方法：

1. 确认Notification Service Extension的配置是否正确 #

• Bundle ID规则：Extension的Bundle ID必须是主App Bundle ID的后缀形式（例如主App是com.yourapp.main，Extension应为com.yourapp.main.NotificationService），且两者必须使用同一个开发者Team ID。
• Info.plist配置：检查Extension的Info.plist中是否正确设置了扩展点标识：

  <key>NSExtension</key>
  <dict>
      <key>NSExtensionPointIdentifier</key>
      <string>com.apple.usernotifications.service</string>
      <key>NSExtensionAttributes</key>
      <dict>
          <!-- 若未指定通知分类，此键可省略；如果设置了分类需确保和推送payload一致 -->
          <key>UNNotificationExtensionCategory</key>
          <string>your_category_id</string>
      </dict>
  </dict>
  

• Push Notification权限：在Extension的Target Capabilities中，确保Push Notifications已开启，且和主App的权限配置一致。

2. 验证推送Payload中的mutable-content字段是否正确 #

你的Node.js代码中设置了notification.mutableContent = true，但需要确认编译后的Payload是否包含"mutable-content": 1。查看console.log(notification.compile())的输出，如果没有这个字段：

• 检查apn库版本，部分旧版本可能需要用notification.setMutableContent(true)替代直接赋值。
• 确保没有其他代码覆盖了mutableContent的设置。

3. 确认测试环境与推送环境匹配 #

你设置了production: false（Sandbox环境），需确保：

• 测试设备上的App是通过Development或Ad Hoc证书安装的，而非App Store版本。
• 如果是App Store安装的App，需将production改为true，否则推送无法正确触发Extension。

4. 检查Extension代码是否被执行 #

在didReceive方法中添加日志，验证Extension是否被触发：

override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
    print("Notification Service Extension triggered!") // 添加日志
    self.contentHandler = contentHandler
    bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
    
    if let bestAttemptContent = bestAttemptContent {
        bestAttemptContent.title = "\(bestAttemptContent.title) [modified]"
        bestAttemptContent.body = "\(bestAttemptContent.body) [modified]"
        contentHandler(bestAttemptContent)
    }
}

然后用Xcode的Debug -> Attach to Process by PID or Name，选择你的Notification Service Extension进程，发送测试推送后查看控制台是否有日志输出。如果没有日志，说明Extension未被触发，需回到配置环节排查。

5. 排除通知权限与显示问题 #

• 确保测试设备上的App已获得推送通知权限，且「设置-通知」中该App的通知权限未被关闭（需开启「允许通知」及「通知中心」）。
• 确认推送的Payload包含alert、badge或sound字段：静默推送（仅content-available:1）不会触发Notification Service Extension。

6. 检查代码逻辑细节 #

• 确认request.content.title和request.content.body不为空：如果推送使用了本地化字符串（如loc-key），需确保对应的本地化资源已正确配置，否则title或body可能为空，导致修改后的文本不明显。
• 确保contentHandler只被调用一次：你的代码中在didReceive里直接调用了contentHandler，逻辑是正确的，但如果后续有其他代码再次调用，可能会覆盖之前的修改。

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