iOS 15 SwiftUI中fullScreenCover绑定@Published变量无法正常关闭问题

问题根因 #

这是SwiftUI模态展示API（fullScreenCover/sheet）的已知行为限制：模态的展示动画是异步执行的，如果你在触发展示后、模态视图的onAppear回调执行前就把绑定的isPresented值设为false，系统内部的模态状态机会丢失dismiss指令，最终导致模态视图卡在展示状态。你观测到的「状态先变为false、遮罩onAppear后触发」的日志时序正好对应这个场景。

可行解决方案 #

方案1：增加最小展示时长兜底（改造成本最低） #

给遮罩增加300ms左右的最小展示时长，这个时长用户几乎感知不到，足够等待遮罩完成展示动画后再执行关闭，适配绝大多数业务场景。
修改AppState的loadData逻辑即可：

func loadData() {
    showLoadingOverlay = true
    let requestStartTime = Date()
    
    // 原有数据请求逻辑
    // ... 数据请求完成后
    
    // 计算已经耗时，不足300ms则补够延迟再关闭
    let usedTime = Date().timeIntervalSince(requestStartTime)
    let delay = max(0, 0.3 - usedTime)
    DispatchQueue.main.asyncAfter(deadline: .now() + delay) {
        self.showLoadingOverlay = false
    }
}

方案2：追踪遮罩挂载状态（无多余延迟） #

如果不能接受任何多余的展示时长，可以通过标记位追踪遮罩的实际挂载状态，只有在遮罩已经完成展示后才执行关闭操作：

1. 先修改AppState增加状态标记：

class AppState:ObservableObject {
  @Published var showLoadingOverlay = false
  // 标记遮罩是否已经完成展示
  private var isOverlayAppeared = false
  // 标记是否有待执行的关闭指令
  private var pendingDismiss = false

  func loadData() {
    // 先重置状态标记
    isOverlayAppeared = false
    pendingDismiss = false
    showLoadingOverlay = true
    
    // 原有数据请求逻辑
    // ... 数据请求完成后
    
    if isOverlayAppeared {
        // 已经展示就直接关闭
        showLoadingOverlay = false
    } else {
        // 还没展示就标记待关闭，等展示后自动触发
        pendingDismiss = true
    }
  }
  
  // 供遮罩调用的挂载通知方法
  func markOverlayDidAppear() {
      isOverlayAppeared = true
      if pendingDismiss {
          showLoadingOverlay = false
          pendingDismiss = false
      }
  }
}

2. 在遮罩的onAppear回调中通知状态更新：

.fullScreenCover(isPresented: $state.showLoadingOverlay) {
  LoadingOverlay()
    .onAppear {
        state.markOverlayDidAppear()
    }
}

方案3：改用item参数版本的模态API（状态同步更可靠） #

SwiftUI的fullScreenCover(item:)API的状态同步逻辑比isPresented版本更严谨，不会因为状态变更过快丢失指令，改造也比较简单：

1. 先定义模态标识类型：

enum AppOverlay: Identifiable {
    case loading
    var id: Self { self }
}

2. 修改AppState的状态定义：

@Published var activeOverlay: AppOverlay? = nil

3. 展示时赋值activeOverlay = .loading，关闭时赋值activeOverlay = nil即可，视图层修改为：

.fullScreenCover(item: $state.activeOverlay) { overlay in
    switch overlay {
    case .loading: LoadingOverlay()
    }
}

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