Transmission项目在macOS Sonoma系统中的线程阻塞问题分析与修复

问题背景

Transmission是一款流行的开源文件共享客户端，近期有用户报告在升级到macOS Sonoma 14.2.1系统后，Transmission 4.0.5版本无法正常启动。应用程序图标会出现在Dock栏，但主界面窗口无法显示，系统出现明显的性能下降。

问题分析

通过分析用户提供的系统日志和崩溃报告，开发团队发现了以下关键现象：

1. 线程数量异常：系统日志显示有198个名为"updateTimeMachineExclude"的线程同时运行，远超正常情况下的数量
2. 线程软限制触发：系统报告"Dispatch Thread Soft Limit Reached: 64"，表明同步操作中阻塞的调度线程过多
3. 备份服务相关调用：大量CSBackupSetItemExcluded调用导致系统资源耗尽

根本原因

问题的根源在于Torrent.mm文件中的Time Machine排除列表更新逻辑。该功能原本设计为并行处理，但在macOS Sonoma系统中，这种实现方式会导致：

1. 每个文件都会触发独立的备份排除检查
2. 并行处理导致系统备份服务被大量并发请求淹没
3. 线程数量呈指数级增长，最终达到系统限制

解决方案

开发团队提出了两阶段修复方案：

第一阶段修复

将updateTimeMachineExclude的DispatchQueue从并行(PARALLEL)改为串行(SERIAL)，这解决了线程数量爆炸的问题，但仍有部分用户报告启动问题。

第二阶段优化

进一步优化备份排除检查的调用机制，确保：

1. 所有备份相关操作都在同一串行队列中执行
2. 减少不必要的重复检查
3. 添加适当的线程同步机制

验证与测试

修复后，用户通过以下步骤验证了解决方案的有效性：

1. 从源码重新构建应用程序
2. 确保使用最新的修复代码
3. 测试应用程序启动和基本功能

验证结果显示应用程序能够正常启动，系统资源使用回归正常水平。

技术启示

这个案例提供了几个重要的技术启示：

1. 系统API的版本兼容性：macOS系统升级可能改变底层API的行为特性
2. 并行处理的陷阱：并非所有操作都适合并行处理，特别是涉及系统服务的调用
3. 构建环境的影响：不同构建方式(Xcode vs CMake)可能产生不同的二进制行为

总结

通过分析线程阻塞问题，Transmission团队快速定位并修复了macOS Sonoma系统下的兼容性问题。这个案例展示了开源社区如何协作解决复杂的系统级问题，也为其他开发者处理类似问题提供了有价值的参考。