Swift异步上下文安全使用非Sendable类型（以NSExtensionContext为例）

核心逻辑要明确 #

NSExtensionContext是绑定主线程的（苹果多数UI相关类默认跑在Main Actor上），且未实现Sendable协议。绝对不能跨Actor传递它的实例，所有对它的操作必须限定在Main Actor上下文内执行。

具体实现步骤 #

1. 直接在Main Actor环境中获取上下文 #

你的UIViewController已经标记为@MainActor，直接在控制器方法里访问extensionContext是安全的，无需额外切换线程：

@MainActor
class ShareViewController: UIViewController {
    private var receivedURL: URL?

    override func viewDidLoad() {
        super.viewDidLoad()
        extractSharedURL()
    }

    private func extractSharedURL() {
        // 在Main Actor上下文内访问extensionContext，无并发风险
        guard let items = extensionContext?.inputItems as? [NSExtensionItem],
              let firstItem = items.first,
              let attachments = firstItem.attachments else {
            return
        }

        // 用@MainActor限定的Task包裹异步加载逻辑
        Task { @MainActor in
            for attachment in attachments {
                if attachment.hasItemConformingToTypeIdentifier(kUTTypeURL as String) {
                    do {
                        let url = try await attachment.loadItem(forTypeIdentifier: kUTTypeURL as String) as? URL
                        receivedURL = url // 直接修改Main Actor隔离的属性，无警告
                        // 后续URL处理逻辑也放在此处，确保在Main Actor上执行
                        processReceivedURL(url)
                    } catch {
                        print("加载URL失败: \(error)")
                    }
                }
            }
        }
    }

    private func processReceivedURL(_ url: URL?) {
        // 所有UI操作或依赖Main Actor的逻辑都在这里处理
        guard let url = url else { return }
        print("获取到分享的URL: \(url)")
        // 这里可以写更新UI等逻辑
    }
}

2. 禁止跨Actor传递NSExtensionContext实例 #

• 不要把extensionContext传入非Main Actor的异步任务、闭包或其他Actor
• 如果需要在其他异步逻辑中使用上下文的数据，只传递数据本身（比如URL，它符合Sendable协议），而非上下文实例

3. 异步加载的正确姿势 #

用Task { @MainActor in }包裹附件加载逻辑，确保整个加载流程和后续属性赋值都在Main Actor上下文内。既利用了async/await的异步能力，又不会触发Sendable警告。

为什么不用@unchecked Sendable #

@unchecked Sendable是强制让编译器忽略类型的Sendable合规性，但NSExtensionContext本身绑定主线程，只要严格在Main Actor上操作，就不存在线程安全问题，完全没必要用这个标记规避警告。

避坑提醒 #

• 不要在Task.detached { ... }这类脱离Main Actor的任务中直接访问extensionContext，必然触发警告
• 不要把extensionContext赋值给Sendable类型的属性，也不要作为参数传递给跨Actor的函数

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