Swift macOS应用HSTracker两类崩溃原因及修复方案咨询

崩溃1：偏好设置面板viewDidLoad阶段崩溃 #

崩溃特征 #

触发路径为点击打开偏好设置入口，在GeneralPreferences控制器执行viewDidLoad方法时崩溃，符号化定位到首行代码：

notifyGameStart.state = Settings.notifyGameStart ? .on : .off

前置校验已确认XIB中所有IBOutlet关联正确。

触发原因 #

该崩溃是第三方偏好设置窗口组件的初始化时序与AppKit生命周期冲突导致：

• 偏好设置窗口控制器在初始化阶段，会遍历所有传入的偏好面板控制器，主动访问控制器的.view属性强制加载视图，以此提前获取每个面板的工具栏图标、标题等配置，该操作会触发AppKit自动调用-[NSViewController _sendViewDidLoad]执行viewDidLoad逻辑。
• 这个预加载时机下，虽然IBOutlet已经完成连接，但XIB解档的最后环节（控件cell配置、target-action绑定、状态同步链路初始化）还未执行完成，此时直接给按钮设置state属性会触发未初始化完成的内部逻辑，触发内存访问异常。
• 少数场景下是因为notifyGameStart属性被标记为weak，在视图未正式加入窗口层级时被ARC意外回收成为野指针，或是Settings.notifyGameStart未配置默认值，类型桥接异常导致崩溃。

修复方案 #

• 把viewDidLoad中所有控件状态赋值、事件绑定的逻辑，整体迁移到viewWillAppear()方法中执行，避开第三方组件预加载视图的特殊时序。
• 将notifyGameStart等控件IBOutlet的属性修饰符从weak改为strong，适配老版本AppKit的XIB加载内存管理逻辑，避免野指针问题。
• 为Settings.notifyGameStart等配置项明确设置默认值，避免UserDefaults缺省值导致的类型桥接错误。

崩溃2：NewDeck模态表单弹出时强制解包崩溃 #

崩溃特征 #

弹出新建卡组的模态表单时，在newDeck.window!强制解包位置触发崩溃，对应代码逻辑：

newDeck = NewDeck(windowNibName: "NewDeck")
if let newDeck = newDeck {
    newDeck.setDelegate(self)
    newDeck.defaultClass = currentClass ?? nil
    self.window!.beginSheet(newDeck.window!, completionHandler: nil)
}

触发原因 #

该崩溃是AppKit下NSWindowController的加载机制特性导致：

• 用windowNibName:初始化NSWindowController子类时，系统不会立刻加载XIB文件创建窗口实例，window属性默认是nil，直到第一次主动访问.window属性时才会触发XIB加载流程。
• 以下场景会导致XIB加载失败，window属性保持为nil，此时强制解包就会触发崩溃：
  • XIB文件未被加入当前Target的Copy Bundle Resources编译阶段，运行时找不到对应nib文件
  • XIB的File's Owner类未设置为NewDeck，或是windowIBOutlet未正确关联到XIB内的窗口实例
  • XIB内的窗口勾选了Release When Closed属性，窗口首次关闭后被系统释放，再次访问时window为nil
  • 传入的nib名称和实际XIB文件名大小写不匹配，或是本地化资源缺失

修复方案 #

• 废弃强制解包写法，用可选绑定安全访问窗口实例，避免解包nil直接崩溃：

  newDeck = NewDeck(windowNibName: "NewDeck")
  guard let newDeck = newDeck, let sheetWindow = newDeck.window else {
      // 可在此处加日志，输出bundle内资源路径排查nib缺失问题
      return
  }
  newDeck.setDelegate(self)
  newDeck.defaultClass = currentClass
  self.window?.beginSheet(sheetWindow, completionHandler: nil)
  

• 排查XIB配置：确认File's Owner类设置正确、window属性关联正常，XIB已加入编译资源列表。
• 取消窗口的Release When Closed勾选，或是在窗口关闭回调中将newDeck实例置为nil，下次弹出时重新初始化，避免访问已释放的窗口实例。
• 初始化控制器后主动调用loadWindow()方法，通过返回的布尔值提前判断XIB是否加载成功，前置处理异常场景。

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