自定义UIContentView/UIContentConfiguration与Swift严格并发冲突？如何解决？

问题场景 #

以下是自定义内容配置和内容视图的极简实现：

struct ExampleContentConfiguration {
  let name: String
  let score: Int
}

extension ExampleContentConfiguration: UIContentConfiguration {
  func makeContentView() -> UIView & UIContentView {
    return ExampleContentView(configuration: self)  // [1]
  }
  
  func updated(for state: UIConfigurationState) -> ExampleContentConfiguration {
    return self
  }
}

final class ExampleContentView: UIView, UIContentView {
  var configuration: UIContentConfiguration  // [2]
  
  init(configuration: ExampleContentConfiguration) {
    self.configuration = configuration
    super.init(frame: .zero)
  }
  
  required init?(coder: NSCoder) {
    fatalError("init(coder:) has not been implemented")
  }
}

当将Strict Concurrency Checking构建设置设为Complete时，Xcode会在标记的两行报告两个错误：

• 在同步非隔离上下文调用主Actor隔离的初始化器init(configuration:)。
• 主Actor隔离的属性configuration无法满足非隔离协议要求。

（注：查看UIListContentView的生成接口时，其configuration属性带有@MainActor注解）

问题原因 #

1. UIView及其子类默认被标记为@MainActor，因此ExampleContentView的初始化器和属性都属于主Actor隔离域。但UIContentConfiguration的makeContentView()方法没有并发注解，Xcode会认为该方法可能在非主Actor上下文调用，从而触发第一个错误。
2. UIContentView协议的configuration属性没有并发注解，但ExampleContentView作为UIView子类，其属性默认受主Actor隔离约束，导致协议要求与隔离规则冲突，触发第二个错误。

解决方案 #

1. 解决初始化器调用错误（[1]处） #

给ExampleContentConfiguration的UIContentConfiguration扩展标记@MainActor，确保所有协议方法都在主Actor上下文执行：

@MainActor
extension ExampleContentConfiguration: UIContentConfiguration {
  func makeContentView() -> UIView & UIContentView {
    return ExampleContentView(configuration: self)
  }
  
  func updated(for state: UIConfigurationState) -> ExampleContentConfiguration {
    return self
  }
}

2. 解决属性隔离冲突（[2]处） #

给ExampleContentView的configuration属性显式标记@MainActor，同时实现类型转换逻辑确保与自定义配置匹配：

final class ExampleContentView: UIView, UIContentView {
  @MainActor var configuration: UIContentConfiguration {
    didSet {
      // 确保配置类型正确，避免类型不匹配问题
      guard let config = configuration as? ExampleContentConfiguration else { return }
      updateUI(with: config)
    }
  }
  
  init(configuration: ExampleContentConfiguration) {
    self.configuration = configuration
    super.init(frame: .zero)
    updateUI(with: configuration)
  }
  
  required init?(coder: NSCoder) {
    fatalError("init(coder:) has not been implemented")
  }
  
  // 统一更新UI的方法
  private func updateUI(with config: ExampleContentConfiguration) {
    // 这里添加实际的UI更新逻辑，比如设置标签文本、分数显示等
  }
}

说明 #

• 给扩展标记@MainActor：确保所有与UI相关的协议方法都在主Actor执行，符合UIKit的并发规则，避免跨Actor调用UI组件的问题。
• 给configuration属性标记@MainActor：虽然UIContentView协议没有并发注解，但Swift允许符合类型给协议成员添加更严格的隔离约束，这与苹果官方的UIListContentView实现逻辑一致，同时解决了隔离冲突问题。

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