App切换至active状态时无法调度本地通知问题求助

需求：每当App变为活跃状态时显示本地通知。
问题：在scenePhase为.active的回调中调用scheduleNotification()无法调度通知，但在onAppear()中调用可成功调度。

相关代码：

struct ContentView: View {
    @EnvironmentObject var notificationManager: NotificationManager
    @Environment(\.scenePhase) private var scenePhase

      var body: some View {
          SomeView()
            .onAppear() {
                // 此处调用可正确调度并发送通知
                // scheduleNotification()
            }
            .onChange(of: scenePhase) { newScenePhase in
                if newScenePhase == .active {  // App正在变为活跃状态
                    // 此处调用无法调度通知，从未发送
                    scheduleNotification()
                }
            }
    }

    func scheduleNotification() {
        notificationManager.sendNotification(id: "BackgroundTask", title: "Background Task", body: "Scheduled successfully", soundName: "Announce", timeInterval: 1)
    }
}

补充NotificationManager类代码：

@MainActor
class NotificationManager: NSObject, ObservableObject, UNUserNotificationCenterDelegate {
    override init() {
        super.init()
        UNUserNotificationCenter.current().delegate = self
    }
    
    func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification) async -> UNNotificationPresentationOptions {
        return [.sound, .banner]
    }
    
    func sendNotification(id: String, title: String, body: String, soundName: String, timeInterval: TimeInterval) {
        let content = UNMutableNotificationContent()
        content.title = title
        content.body = body
        content.sound = UNNotificationSound(named: UNNotificationSoundName("\(soundName).wav"))
        let trigger = UNTimeIntervalNotificationTrigger(timeInterval: timeInterval, repeats: false)
        let req = UNNotificationRequest(identifier: id, content: content, trigger: trigger)
        UNUserNotificationCenter.current().add(req, withCompletionHandler: nil)
    }
}

原因分析与解决方案 #

核心原因 #

1. 固定通知ID导致的覆盖问题
   每次调度通知都使用固定ID BackgroundTask，如果App频繁切换后台/前台，新的通知请求会直接替换未触发的旧请求，最终可能导致通知无法按时触发；即使通知已触发，重复使用同一ID也可能触发系统的隐性限制。

2. 无错误处理，无法排查添加失败原因
   当前代码未处理UNUserNotificationCenter.add()的回调错误，无法确认是通知添加失败，还是触发后未展示。

3. App活跃状态切换时的系统调度限制
   当scenePhase切换至.active时，App刚完成前台激活，此时立即调度1秒后触发的通知，系统可能因检测到用户正在交互，暂时抑制通知展示。

解决方案 #

1. 使用唯一通知ID

每次调度通知时生成唯一ID，避免请求被覆盖：

func scheduleNotification() {
    // 用UUID生成唯一ID
    notificationManager.sendNotification(id: UUID().uuidString, title: "Background Task", body: "Scheduled successfully", soundName: "Announce", timeInterval: 1)
}

2. 添加错误处理排查问题

修改sendNotification方法，添加回调错误打印，确认通知是否成功添加：

func sendNotification(id: String, title: String, body: String, soundName: String, timeInterval: TimeInterval) {
    let content = UNMutableNotificationContent()
    content.title = title
    content.body = body
    content.sound = UNNotificationSound(named: UNNotificationSoundName("\(soundName).wav"))
    let trigger = UNTimeIntervalNotificationTrigger(timeInterval: timeInterval, repeats: false)
    let req = UNNotificationRequest(identifier: id, content: content, trigger: trigger)
    UNUserNotificationCenter.current().add(req) { error in
        if let error = error {
            print("通知添加失败：\(error.localizedDescription)")
        } else {
            print("通知已成功添加")
        }
    }
}

3. 延迟调度通知

在scenePhase切换至.active后，延迟一小段时间再调度通知，确保App完全进入稳定活跃状态：

.onChange(of: scenePhase) { newScenePhase in
    if newScenePhase == .active {
        DispatchQueue.main.asyncAfter(deadline: .now() + 0.5) {
            scheduleNotification()
        }
    }
}

4. 确保通知权限已获取

在NotificationManager中添加权限请求方法，并在App启动时调用，避免因权限问题导致通知失败：

@MainActor
class NotificationManager: NSObject, ObservableObject, UNUserNotificationCenterDelegate {
    // ... 原有代码 ...
    
    func requestNotificationPermissions() async {
        let center = UNUserNotificationCenter.current()
        do {
            try await center.requestAuthorization(options: [.alert, .sound, .badge])
        } catch {
            print("通知权限请求失败：\(error)")
        }
    }
}

然后在ContentView的onAppear中调用：

.onAppear() {
    Task {
        await notificationManager.requestNotificationPermissions()
    }
}

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