iOS如何在系统展示前拦截远程通知并将其静音？

针对你遇到的“本地取消Firebase主题订阅但服务器未同步，导致后台/未运行时收到不该有的通知”问题，最可靠的方案是利用iOS Notification Service Extension——它能在通知展示给用户前拦截并修改通知内容（包括设置静音），无论应用处于后台还是完全未运行状态。

具体实现步骤 #

1. 创建Notification Service Extension #

• 打开Xcode，在你的项目中点击File > New > Target
• 选择Notification Service Extension，点击Next
• 填写Extension的名称（比如NotificationSilencer），确保语言和主应用一致，点击Finish
• 当Xcode询问是否激活Scheme时，选择Activate

2. 配置App Groups（共享本地数据） #

因为Extension和主应用是独立进程，需要通过App Groups共享“已取消订阅的主题列表”：

• 分别在主应用和Extension的Signing & Capabilities中，点击+ Capability，添加App Groups
• 点击+按钮，创建一个Group ID（比如group.com.yourcompany.yourapp），确保主应用和Extension都勾选这个Group

3. 主应用中存储已取消的主题 #

当用户取消Firebase主题订阅时，将主题名称存入共享的UserDefaults：

import FirebaseMessaging

func unsubscribeFromTopic(_ topicName: String) {
    // 存储到共享的UserDefaults
    let sharedDefaults = UserDefaults(suiteName: "group.com.yourcompany.yourapp")!
    var cancelledTopics = sharedDefaults.array(forKey: "CancelledFirebaseTopics") as? [String] ?? []
    if !cancelledTopics.contains(topicName) {
        cancelledTopics.append(topicName)
        sharedDefaults.set(cancelledTopics, forKey: "CancelledFirebaseTopics")
        sharedDefaults.synchronize()
    }
    
    // 调用Firebase取消订阅
    Messaging.messaging().unsubscribe(fromTopic: topicName)
}

4. 在Extension中拦截并静音通知 #

修改Extension的NotificationService.swift代码，实现拦截逻辑：

import UserNotifications

class NotificationService: UNNotificationServiceExtension {

    var contentHandler: ((UNNotificationContent) -> Void)?
    var bestAttemptContent: UNMutableNotificationContent?

    override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
        self.contentHandler = contentHandler
        bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
        
        guard let bestAttemptContent = bestAttemptContent else {
            contentHandler(request.content)
            return
        }
        
        // 从共享UserDefaults获取已取消的主题列表
        let sharedDefaults = UserDefaults(suiteName: "group.com.yourcompany.yourapp")!
        let cancelledTopics = sharedDefaults.array(forKey: "CancelledFirebaseTopics") as? [String] ?? []
        
        // 解析Firebase通知中的主题标识（这里假设服务器在payload中添加了"topic"字段）
        if let topic = bestAttemptContent.userInfo["topic"] as? String, cancelledTopics.contains(topic) {
            // 将通知设置为静音
            bestAttemptContent.sound = nil
            // 可选：修改通知内容提示用户已取消订阅
            // bestAttemptContent.title = "已取消订阅"
            // bestAttemptContent.body = "该主题通知已静音"
        }
        
        // 提交修改后的通知内容
        contentHandler(bestAttemptContent)
    }
    
    override func serviceExtensionTimeWillExpire() {
        // 超时 fallback，使用原始通知内容
        if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
            contentHandler(bestAttemptContent)
        }
    }

}

5. 确保服务器通知Payload格式正确 #

Firebase发送的通知需要包含自定义的topic字段，这样Extension才能识别主题。比如服务器发送的payload示例：

{
  "to": "/topics/your_topic",
  "notification": {
    "title": "New Message",
    "body": "Hello World"
  },
  "data": {
    "topic": "your_topic"
  }
}

额外说明 #

• 兼容性：Notification Service Extension支持iOS 10及以上版本，覆盖绝大多数用户
• 性能注意：Extension的处理时间有限（约30秒），所以逻辑要尽量简洁，避免耗时操作
• 前台通知处理：如果应用在前台收到通知，可以通过UNUserNotificationCenterDelegate的willPresentNotification方法直接拦截不展示，逻辑类似

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