Swift并发警告解决：MainActor环境下[String:Any]?跨Actor边界问题

问题场景 #

定义如下类及异步方法：

public final class MyClass {
  static let shared = MyClass()

  public func doSomething(dictionary: [String: Any]? = nil) async -> UIViewController {
    return await UIViewController()
  }
}

在UIViewController中调用该方法：

final class MyViewController: UIViewController {
  @IBAction private func tapButton() {
    Task {
      let vc = await MyClass.shared.doSomething()
    }
  }
}

触发警告：

Non-sendable type '[String : Any]?' exiting main actor-isolated context in call to non-isolated instance method 'doSomething(dictionary:)' cannot cross actor boundary

注：仅当Xcode Build Settings中Strict Concurrency Checking设为Complete或Targeted时会显示此警告。已知UIViewController方法默认隔离在MainActor中，且需保留tapButton()的该特性，需消除警告。

解决方案 #

方案1：让参数类型符合Sendable协议（推荐） #

警告核心是[String: Any]?不属于Sendable类型（Any无法保证线程安全），优先调整参数类型以满足并发安全要求：

• 如果字典内元素均为Sendable类型，直接修改参数类型：

  public func doSomething(dictionary: [String: Sendable]? = nil) async -> UIViewController {
    return await UIViewController()
  }
  

• 若必须使用[String: Any]，且能确保字典内容线程安全，可标记为@unchecked Sendable：

  public func doSomething(dictionary: @unchecked Sendable [String: Any]? = nil) async -> UIViewController {
    return await UIViewController()
  }
  

方案2：将doSomething方法绑定到MainActor #

让方法与调用方同属MainActor上下文，避免参数跨Actor传递：

public final class MyClass {
  static let shared = MyClass()

  @MainActor
  public func doSomething(dictionary: [String: Any]? = nil) async -> UIViewController {
    return await UIViewController()
  }
}

说明 #

Swift严格并发检查要求跨Actor传递的类型必须符合Sendable协议，以保证线程安全。优先选择方案1从类型层面解决合规问题，若业务逻辑要求方法必须在非MainActor执行，方案1是唯一安全选择；若方法本身无需脱离主线程执行，方案2更简洁。

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