Stats 应用启动崩溃问题分析与解决方案

问题背景

Stats 是一款 macOS 系统监控工具，近期有用户反馈在启动应用时出现崩溃现象。经过深入分析，我们发现这是一个与磁盘模块相关的边界条件问题，当系统检测到某些特殊磁盘状态时会导致应用崩溃。

崩溃现象

用户在 macOS Sonoma 14.6.1 系统上运行 Stats 2.11.9 版本时，应用启动后立即崩溃，主要表现包括：

1. 应用图标不显示
2. 偶尔出现小组件快速闪现后消失
3. 控制台输出错误日志："Couldn't read values in CFPrefsPlistSource"

问题定位

通过分析崩溃日志和调试信息，我们发现崩溃发生在磁盘模块的初始化过程中。具体问题出现在 Disk/popup.swift 文件的 init(width:size:free:) 方法中，当尝试创建 NSView 时触发 EXC_BREAKPOINT 异常。

关键错误点在于：

self.usedBarSpace = NSView(frame: NSRect(x: 0, y: 0, width: width, height: view.frame.height))

根本原因

深入调试后发现，当系统检测到某些磁盘时，会出现以下异常情况：

1. 磁盘总容量(size)和可用空间(free)同时返回0值
2. 在计算磁盘使用百分比时，导致产生NaN(非数字)值
3. 当尝试使用NaN值作为视图宽度时，触发系统级崩溃

这种情况通常发生在：

• 外部磁盘连接不稳定时
• 特殊系统分区
• 磁盘驱动程序异常时

解决方案

开发者通过以下步骤解决了该问题：

1. 在磁盘空间计算函数中添加防御性检查
2. 对返回0值的磁盘进行过滤处理
3. 确保所有数学计算都有有效的数值边界

关键修复代码逻辑：

// 添加对0值磁盘的检查
guard size > 0 else {
    return nil
}

// 确保百分比计算有效
let percentage = size > 0 ? CGFloat(size - free) / CGFloat(size) : 0
let width = max(0, min(view.frame.width, view.frame.width * percentage))

预防措施

为避免类似问题，建议：

1. 对所有外部输入数据进行有效性验证
2. 数学计算前检查除数不为零
3. 对可能产生NaN的操作进行保护
4. 添加完善的错误日志记录

用户建议

如果遇到类似问题，用户可以：

1. 检查所有连接的磁盘状态
2. 尝试断开外部设备后启动应用
3. 更新到最新版本的Stats应用
4. 必要时运行磁盘工具进行修复

总结

这个案例展示了边界条件处理在软件开发中的重要性。即使是看似简单的磁盘空间计算，也可能因为特殊系统状态而导致应用崩溃。通过添加适当的防御性编程和错误处理，可以显著提高应用的稳定性和可靠性。

Stats开发团队快速响应并解决了这个边缘案例，体现了对产品质量的重视。用户遇到类似问题时，建议及时反馈并提供详细的系统环境信息，以帮助开发者更快定位问题。