如何正确从async函数访问@MainActor标注的单例？

问题场景 #

我定义了一个全局共享的单例类InteractorManager，代码如下：

class InteractorManager: ObservableObject {
  @MainActor static let shared = InteractorManager()
  
  private init() { }
  
  func initialDataLoading() async throws {
    try await // 加载数据的代码
  }
}

在异步函数中调用该单例的方法时：

private func handleDataInitialization() async {
  do {
    try await InteractorManager.shared.initialDataLoading()
  } catch {
    // 错误处理
  }
}

执行Product -> Run时代码正常运行，但执行Product -> Archive时编译失败，报错：

Sending main actor-isolated value of type 'InteractorManager' with later accesses to nonisolated context risks causing data races

已尝试给函数添加@MainActor标注、在Task { @MainActor in }中调用、清理构建缓存等方法，但归档时错误依然存在。

解决方案 #

核心问题是仅标记静态shared属性为@MainActor，但类本身未被MainActor隔离，导致编译器在归档的严格检查模式下，判定访问单例实例存在跨上下文的数据竞争风险。

正确的做法是将整个InteractorManager类标记为@MainActor，这样类的所有属性、方法都会自动绑定到MainActor上下文：

@MainActor
class InteractorManager: ObservableObject {
  static let shared = InteractorManager()
  
  private init() { }
  
  func initialDataLoading() async throws {
    try await // 加载数据的代码
  }
}

之后调用时，只需根据调用上下文选择合适的方式：

• 如果调用handleDataInitialization的代码本身在非MainActor上下文，直接异步调用即可（initialDataLoading作为MainActor隔离方法，会自动切换到MainActor执行）：

private func handleDataInitialization() async {
  do {
    try await InteractorManager.shared.initialDataLoading()
  } catch {
    // 错误处理
  }
}

• 若需强制在MainActor执行，可简化为：

private func handleDataInitialization() async {
  await MainActor.run {
    do {
      try await InteractorManager.shared.initialDataLoading()
    } catch {
      // 错误处理
    }
  }
}

为何之前的方法无效 #

• 仅给handleDataInitialization加@MainActor：虽然函数在MainActor执行，但编译器仍会担心shared实例被传递到非隔离上下文（类本身未标记MainActor）。
• 使用Task { @MainActor in }：该方式会创建新的MainActor任务，但原函数的异步上下文存在模糊性，编译器在严格模式下仍会判定风险。

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