SourceGit项目在MacOS上的文件监控崩溃问题分析

问题背景

SourceGit是一款基于Avalonia框架开发的跨平台Git客户端工具。在2025年1月的版本中，MacOS用户报告了一个偶发性崩溃问题。该问题表现为当用户进行其他操作时，应用程序会意外终止，但直接操作时却不会出现崩溃。

崩溃原因分析

从崩溃日志中可以清晰地看到，问题根源在于文件系统监控模块中的集合修改异常。具体错误信息显示："Collection was modified; enumeration operation may not execute"，这是一个典型的并发修改异常。

技术细节

1. 线程安全问题：崩溃发生在文件系统监控回调线程中，当工作目录发生变化时，Watcher模块尝试枚举一个正在被修改的集合。

2. 调用栈分析：

   • 崩溃始于OnWorkingCopyChanged方法
   • 通过FileSystemWatcher的事件回调触发
   • 最终在FSEventStream的事件处理线程中抛出异常

3. 平台特性：MacOS使用FSEvents API进行文件系统监控，这与Windows和Linux的实现机制不同，导致特定平台下的并发问题。

解决方案

开发团队通过以下方式解决了这个问题：

1. 线程同步机制：在集合访问处添加了适当的锁机制，确保枚举操作期间集合不会被修改。

2. 事件处理优化：重构了文件系统变更事件的处理流程，避免在事件回调中直接操作共享集合。

3. 异步处理队列：引入消息队列机制，将文件系统事件的处理转移到专用线程，减少主线程压力。

经验总结

1. 跨平台开发中，文件系统监控是一个常见但容易出问题的功能点，各平台实现差异较大。

2. 集合操作在多线程环境下必须考虑线程安全问题，特别是在事件回调这类异步场景中。

3. 对于GUI应用程序，长时间运行后的偶发崩溃往往与资源管理和线程同步有关，需要特别关注。

该问题的修复体现了SourceGit团队对稳定性的重视，也为其他跨平台GUI应用的开发提供了有价值的参考案例。