表盘已显示complication时CLKComplicationServer的activeComplications为nil是什么原因

可能的原因 #

1. watchOS 版本API行为变更 #

watchOS 10及以上版本对CLKComplicationServer的访问逻辑做了收紧调整：当Watch App处于后台未激活状态、或是扩展刚启动还未完成和表盘的状态同步时，即便你的complication已经正常在表盘显示，activeComplications属性也会返回nil，这是系统更新后引入的默认行为变更。

2. 系统complication关联缓存异常 #

系统大版本更新后经常会出现App与已添加表盘complication的绑定缓存异常，此时表盘虽然能正常渲染你之前设置的complication占位符，但系统没有把这些complication的实例关联到你App的CLKComplicationServer实例上，导致读取属性为空。

3. API调用时机不符合系统要求 #

如果你的updateComplications方法是在Watch扩展启动的早期阶段（比如ExtensionDelegate.applicationDidFinishLaunching、视图的onAppear刚触发时）调用，此时CLKComplicationServer还未完成初始化加载，activeComplications还未被系统赋值，就会返回nil。

4. ClockKit与WidgetKit共存冲突 #

如果你的App后续新增了基于WidgetKit实现的complication，watchOS会优先处理WidgetKit类型的complication注册逻辑，可能导致旧的ClockKit实现的activeComplications读取为空，哪怕ClockKit的complication已经在表盘展示。

排查方案 #

• 调用updateComplications前先监听CLKComplicationServerActiveComplicationsDidChangeNotification系统通知，收到通知后再访问activeComplications属性
• 真机测试时先删除表盘上已添加的你的App的complication，重新添加一次，清除系统旧缓存
• 对于watchOS 10+设备，将updateComplications的调用时机延迟到App进入前台2~3秒后再触发，避开系统初始化阶段
• 如果你已经适配了WidgetKit的complication，优先使用WidgetKit的reloadAllTimelines相关接口更新complication内容，ClockKit的相关API在新版本系统已处于被逐步废弃的状态

// 优化后的调用示例
final class ComplicationController: NSObject, CLKComplicationDataSource {
    override init() {
        super.init()
        // 监听activeComplications变更通知
        NotificationCenter.default.addObserver(
            self,
            selector: #selector(updateComplications),
            name: .CLKComplicationServerActiveComplicationsDidChange,
            object: nil
        )
    }

    @objc func updateComplications() {
        let complicationServer = CLKComplicationServer.sharedInstance()
        guard let activeComplications = complicationServer.activeComplications else {
            // 未获取到activeComplications时可延迟重试
            DispatchQueue.main.asyncAfter(deadline: .now() + 2) { [weak self] in
                self?.updateComplications()
            }
            return
        }
        for complication in activeComplications {
            complicationServer.reloadTimeline(for: complication)
        }
    }
}

内容的提问来源于stack exchange，提问作者Reinhard Männer