SwiftUI iOS：关闭Bottom Sheet后切换Watchlist Tab返回启动页问题

问题根源分析 #

这个问题的核心是自定义Bottom Sheet的onDismiss回调与嵌套TabView的状态变化、fullScreenCover的模态控制状态产生了冲突：当Bottom Sheet关闭后，onDismiss中的操作（尤其是异步操作）还未完成时，切换Watchlist内部的分页Tab，会触发视图层级的重绘或状态传递，意外将控制启动页fullScreenCover的绑定值置为false，导致模态被关闭，退回启动页。

具体解决方案 #

1. 隔离模态控制状态与子视图状态 #

将控制启动页fullScreenCover的状态提升至全局或App层级的ObservableObject中，避免子视图（尤其是嵌套Tab和Bottom Sheet）的状态修改意外影响到模态的显示状态：

class AppRouter: ObservableObject {
    @Published var isAppSwitcherPresented = true
}

// 启动页实现
struct LaunchView: View {
    @StateObject private var router = AppRouter()
    
    var body: some View {
        LaunchContent()
            .fullScreenCover(isPresented: $router.isAppSwitcherPresented) {
                ApplicationSwitcher()
                    .environmentObject(router)
            }
    }
}

确保所有子视图只通过EnvironmentObject访问路由状态，且绝对不在Bottom Sheet的onDismiss中修改该状态。

2. 异步onDismiss操作加状态锁 #

如果onDismiss中包含异步操作（如网络请求、数据持久化），添加一个状态标志位，禁止在操作完成前切换Tab：

struct WatchlistView: View {
    @State private var isBottomSheetDismissing = false
    @State private var showBottomSheet = false
    
    var body: some View {
        TabView {
            Text("Watchlist Tab 1")
            Text("Watchlist Tab 2")
        }
        .tabViewStyle(.page)
        .disabled(isBottomSheetDismissing) // 操作完成前禁用Tab切换
        .onTapGesture {
            showBottomSheet = true
        }
        .bottomSheet(isPresented: $showBottomSheet, onDismiss: {
            Task {
                isBottomSheetDismissing = true
                await performPostDismissTasks() // 执行异步操作
                isBottomSheetDismissing = false
            }
        }) {
            BottomSheetContent()
        }
    }
    
    private func performPostDismissTasks() async {
        // 模拟异步任务：数据更新、统计上报等
        try? await Task.sleep(nanoseconds: 1_500_000_000)
    }
}

3. 修复自定义Bottom Sheet的状态实现 #

检查自定义Bottom Sheet的实现，避免使用可能与父视图模态状态冲突的绑定逻辑：

• 优先使用SwiftUI原生的@Environment(\.dismiss)来关闭Bottom Sheet，而非自定义绑定值
• 确保Bottom Sheet的状态只由自身的@State或局部ObservableObject控制，不向外传递可能干扰父视图的状态变化

4. 避免在onDismiss中触发视图重绘 #

如果onDismiss中需要更新视图数据，尽量使用@Published属性且避免同步触发大量视图重绘：

class WatchlistViewModel: ObservableObject {
    @Published var items: [WatchlistItem] = []
    
    func updateAfterBottomSheetDismiss() async {
        let newItems = await fetchUpdatedItems()
        DispatchQueue.main.async {
            self.items = newItems // 主线程更新，避免跨线程状态冲突
        }
    }
}

关键注意事项 #

• 永远不要让子视图直接修改控制顶层模态（如fullScreenCover）的状态，通过路由对象统一管理
• 异步操作必须明确标记状态，避免用户在操作未完成时触发视图切换
• 自定义组件（如Bottom Sheet）的状态管理要完全隔离，防止状态冒泡影响上层视图

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