Swift Snapshot Testing 主线程与主队列死锁问题解析

问题背景

在 Swift Snapshot Testing 项目的 1.18.0 版本中，引入了一个关于主线程检测的修改，这个改动虽然解决了某些问题，但却意外地引入了一个新的使用限制。这个限制影响了特定的代码模式，特别是当测试代码运行在主线程但不是主队列的情况下。

技术细节分析

Swift Snapshot Testing 的核心功能 assertSnapshot 方法在执行时需要确保运行在正确的线程上下文中。1.18.0 版本的改动将线程检测逻辑从简单的 Thread.isMainThread 检查改为更严格的 DispatchQueue.main 队列检查。

这种改变带来了一个微妙的区别：

• Thread.isMainThread 只检查代码是否在主线程执行
• DispatchQueue.main 检查则要求代码必须在主队列上执行

虽然主队列的代码总是在主线程执行，但反过来却不成立 - 主线程上运行的代码不一定在主队列中执行。这种差异正是导致问题的根源。

典型问题场景

在实际开发中，我们经常会遇到以下两种典型情况：

1. 数据库操作场景：许多数据库框架（如 GRDB）会在主线程上执行读取操作，但使用自定义的调度队列而非主队列。这种情况下，虽然代码运行在主线程，但不在主队列上。

2. 自定义队列同步调用：开发者在主线程上创建并同步执行一个自定义队列的任务时，代码会在主线程执行，但调度上下文仍然是自定义队列而非主队列。

解决方案

Swift Snapshot Testing 团队在后续版本中修复了这个问题，恢复使用 Thread.isMainThread 进行检测，同时保留了必要的安全性检查。这种方案：

1. 保持了框架的易用性，不会破坏现有的测试代码
2. 仍然能够防止在错误的线程上下文中执行快照测试
3. 兼容各种数据库框架和自定义队列的使用模式

最佳实践建议

基于这个问题的经验，我们在使用快照测试时应该注意：

1. 理解线程与队列的区别：线程是执行路径，队列是任务调度机制
2. 对于需要在特定队列中执行的操作，明确指定目标队列
3. 在编写测试时，考虑被测代码的线程/队列使用情况
4. 当升级测试框架时，特别注意线程相关变更的影响

总结

Swift Snapshot Testing 框架的这个变更提醒我们，在并发编程中，线程和队列虽然相关但不等同。框架设计需要在严格性和灵活性之间找到平衡点，而这次问题的解决正是找到了这样一个平衡点，既保证了功能正确性，又不会对现有代码造成破坏性影响。