NSDictionary在@Sendable闭包中被捕获的警告风险咨询

我编写了一个Objective-C风格的Swift函数，用于执行异步任务并调用可选的完成闭包：

@objc func setParams(
  _ params: NSDictionary,
  completion: (() -> Void)?
) {
  Task {
    if let params = params as? [String: Any] { // 此处出现警告
      await handle(params)
    }
    completion?()
  }
}

收到的警告：

Capture of 'params' with non-sendable type 'NSDictionary' in a @Sendable closure

我了解NSDictionary并非Sendable类型，但想知道该场景下此警告是否有实际影响？可能会引发什么问题？

警告的实际影响与潜在风险 #

这个警告并非虚设，它直接指向了并发场景下的安全隐患：

• 线程安全风险：NSDictionary是Objective-C类，本身不具备线程安全性（即便它是不可变实例，Swift也无法通过静态检查保证这一点）。当你在Task的@Sendable闭包中捕获它时，闭包可能在任意后台线程执行，如果此时有其他线程对这个NSDictionary进行修改，就会触发数据竞争，导致崩溃、数据错乱或其他不可预测的行为。
• 违反Swift并发模型规范：Swift的结构化并发要求跨线程传递的类型必须符合Sendable协议——要么是值类型（天然线程安全），要么是线程安全的引用类型。NSDictionary不满足这个要求，编译器无法保证它在跨线程访问时的安全性，因此抛出警告。

为什么当前代码可能暂时无异常？ #

如果你的params实例是不可变的（创建后从未被修改），或者所有访问操作都在同一线程执行，可能不会立刻出现问题，但这种安全是脆弱的——后续代码迭代中，一旦有人修改params的使用逻辑，或者引入其他并发操作，隐藏的风险就会被触发。

解决警告的可行方案 #

1. 提前转换为Swift原生类型：在进入Task之前完成类型转换，避免在闭包中捕获NSDictionary：

   @objc func setParams(
     _ params: NSDictionary,
     completion: (() -> Void)?
   ) {
     let swiftParams = params as? [String: Any]
     Task {
       if let params = swiftParams {
         await handle(params)
       }
       completion?()
     }
   }
   

   只要[String: Any]中的元素都是Sendable类型，这个Swift字典就会自动符合Sendable，彻底规避NSDictionary的捕获问题。
2. 手动标记为Sendable（谨慎使用）：如果你能100%保证该NSDictionary是不可变且线程安全的，可以通过扩展让它符合Sendable（但这是手动担保，编译器不会做安全检查）：

   extension NSDictionary: @unchecked Sendable {}
   

   注意：这种方式相当于跳过编译器的安全校验，若实际存在线程不安全的场景，会隐藏风险，仅在完全确定安全时使用。
3. 使用线程安全容器：如果需要对字典进行修改操作，建议用NSMapTable（Objective-C）或Swift的Actor来封装，确保所有访问操作都是线程安全的。

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