TestFlight构建版本本地通知失效问题求助

问题概述 #

开发了一款通过TestFlight分发的亲友用应用，使用UserNotifications框架实现每周固定时间推送本地通知，但仅自己的开发者设备能收到通知，所有TestFlight用户（已确认开启应用通知权限）均无法接收。实现逻辑为应用启动时循环调度30条通知，每条通知使用唯一标识符，先删除旧的同ID待推送通知，再添加新通知；权限请求代码如用户提供所示。

可能原因及排查/解决步骤 #

1. 时区处理错误 #

本地通知的UNCalendarNotificationTrigger如果使用固定时区（比如UTC），而用户设备时区与开发者设备不同，会导致通知触发时间与预期不符，看起来像是没收到。

解决：
创建触发器时明确使用用户当前时区：

let dateComponents = DateComponents(
    year: 2024, 
    month: 5, 
    day: 15, 
    hour: 10, 
    minute: 30, 
    timeZone: .current // 使用当前设备时区
)
let trigger = UNCalendarNotificationTrigger(dateMatching: dateComponents, repeats: true)

2. 异步调用未在主线程执行 #

用户提供的checkForNotificationsPermission中，闭包回调在后台线程执行，直接调用dispatchNotifications()可能导致UNUserNotificationCenter操作异常（官方称API线程安全，但主线程执行更可靠）。

解决：
将dispatchNotifications()切换到主线程调用：

func checkForNotificationsPermission() {
    let notificationCenter = UNUserNotificationCenter.current()
    notificationCenter.getNotificationSettings { settings in
        DispatchQueue.main.async { // 切换到主线程
            switch settings.authorizationStatus {
            case .authorized:
                self.dispatchNotifications()
            case .notDetermined:
                notificationCenter.requestAuthorization(options: [.alert, .sound]) { didAllow, error in
                    DispatchQueue.main.async { // 同样切换到主线程
                        if didAllow {
                            self.dispatchNotifications()
                        }
                    }
                }
            default:
                return
            }
        }
    }
}

3. Async/Await迁移后的流程问题 #

迁移到async/await架构时若未正确处理异步等待，可能导致通知调度逻辑未完整执行。

解决：
改用async/await版本的API，确保所有操作等待完成：

func checkForNotificationsPermission() async {
    let notificationCenter = UNUserNotificationCenter.current()
    let settings = await notificationCenter.notificationSettings()
    
    switch settings.authorizationStatus {
    case .authorized:
        await dispatchNotifications()
    case .notDetermined:
        do {
            let didAllow = try await notificationCenter.requestAuthorization(options: [.alert, .sound])
            if didAllow {
                await dispatchNotifications()
            }
        } catch {
            print("权限请求失败: \(error.localizedDescription)")
        }
    default:
        return
    }
}

func dispatchNotifications() async {
    let notificationCenter = UNUserNotificationCenter.current()
    
    for index in 0..<30 {
        let identifier = "weekly-notification-\(index)" // 确保唯一标识符
        // 删除旧通知
        await notificationCenter.removePendingNotificationRequests(withIdentifiers: [identifier])
        
        // 构建通知内容和触发器（示例）
        let content = UNMutableNotificationContent()
        content.title = "每周提醒"
        content.body = "这是第\(index+1)条测试通知"
        content.sound = .default
        
        // 假设每周不同日期的固定时间，替换为你的实际日期逻辑
        let weekday = (index % 7) + 1 // 周一到周日
        let dateComponents = DateComponents(hour: 9, minute: 0, weekday: weekday, timeZone: .current)
        let trigger = UNCalendarNotificationTrigger(dateMatching: dateComponents, repeats: true)
        
        // 添加新通知
        let request = UNNotificationRequest(identifier: identifier, content: content, trigger: trigger)
        do {
            try await notificationCenter.add(request)
            print("通知\(identifier)已调度")
        } catch {
            print("调度通知\(identifier)失败: \(error.localizedDescription)")
        }
    }
    
    // 调试用：打印当前待推送通知数量
    let pendingRequests = await notificationCenter.pendingNotificationRequests()
    print("当前待推送通知总数: \(pendingRequests.count)")
}

4. 通知标识符或调度逻辑问题 #

如果循环中标识符不唯一，或者删除/添加操作顺序错误，可能导致通知未被正确添加。

排查：

• 确保每个通知的标识符全局唯一，避免重复覆盖；
• 在dispatchNotifications中添加日志，确认每条通知都被成功删除并添加；
• 在TestFlight设备上通过Xcode连接查看控制台日志，排查是否有添加通知的错误信息。

5. iOS版本兼容性 #

如果TestFlight用户的iOS版本低于你使用的UserNotifications API最低要求，会导致通知无法调度。

排查：

• 确认应用部署目标版本与用户设备iOS版本匹配；
• 避免使用仅在高版本iOS中可用的API（比如某些UNNotificationContent的新属性）。

关于开发者账号的猜测 #

本地通知是在设备本地调度的，与开发者账号绑定、TestFlight用户角色无关，因此该猜测不成立。

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