ObjC Mac应用监听NSUserDefaults收到多次重复KVO回调问题

你遇到的单次NSUserDefaults值修改触发最多8条同值KVO回调，不是重复注册监听、控件绑定逻辑错误导致的，是Foundation框架对NSUserDefaults的KVO实现固有特性：
NSUserDefaults的键值存储是跨多级优先级搜索域实现的，包含应用自定义域、全局系统域、语言区域域、托管配置域、注册默认值域等共8个内部域节点。每次调用setBool:forKey:修改值时，系统会逐域同步更新对应状态，每个域节点的状态更新都会向外抛一次KVO变更通知，哪怕最终对外暴露的键值全程没有发生二次变化，也会产生多条回调。
苹果官方文档从未将NSUserDefaults列为保证KVO通知单次触发的类，仅能保证修改后可以收到变更通知，不承诺通知触发次数，这也是你移除控件绑定后手动赋值仍会收到重复回调的根本原因。

按兼容性和侵入性从优到劣排序：

• 值去重拦截（最推荐）
  这是最稳定、无版本兼容问题的方案。在监听类中持有一个本地变量，记录上一次实际处理过的目标属性值，每次收到KVO回调时先对比新值和缓存值，仅当值真实发生变化时才执行业务逻辑，直接过滤所有同值重复回调。
  核心实现代码：

  // 监听类的私有扩展中声明缓存属性
  @property (nonatomic, assign) BOOL cachedPropertyValue;
  

  // 注册KVO前先初始化缓存值
  NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults];
  self.cachedPropertyValue = [defaults boolForKey:@"property"];
  [defaults addObserver:self 
             forKeyPath:@"property" 
                options:NSKeyValueObservingOptionNew 
                context:nil];
  

  // KVO回调中做去重拦截
  - (void)observeValueForKeyPath:(NSString *)keyPath
                        ofObject:(id)object
                          change:(NSDictionary<NSKeyValueChangeKey,id> *)change
                         context:(void *)context {
      if (object == [NSUserDefaults standardUserDefaults] && 
          [keyPath isEqualToString:@"property"]) {
          BOOL newValue = [change[NSKeyValueChangeNewKey] boolValue];
          // 同值重复回调直接跳过
          if (newValue == self.cachedPropertyValue) {
              return;
          }
          self.cachedPropertyValue = newValue;
          // 此处编写实际业务处理逻辑
          return;
      }
      [super observeValueForKeyPath:keyPath ofObject:object change:change context:context];
  }
  

• 改用系统自带的defaults变更通知
  不要直接对NSUserDefaults实例注册KVO，改为监听NSUserDefaultsDidChangeNotification全局通知，该通知会在整次defaults值更新流程全部完成后触发1次，不会产生重复回调。收到通知后主动读取目标键的值，对比缓存值判断是否需要执行业务逻辑即可。
  注意该方案需要在对象销毁时主动移除通知监听。
• 绕开对NSUserDefaults的直接监听
  如果是和NSButton等控件绑定的场景，可以直接移除对defaults的KVO监听，通过控件的target-action机制响应点击事件，在事件方法中主动更新NSUserDefaults值、执行业务逻辑，完全绕开defaults自带的KVO分发链路，也能避免重复回调问题。

注意：不要尝试通过硬编码回调次数、识别内部通知来源的方式过滤重复回调，NSUserDefaults的内部域实现是系统私有逻辑，不同macOS版本的触发顺序、回调数量可能发生变化，这类硬编码逻辑会在系统升级后失效。

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