iOS应用同时使用.backgroundTask与.scenePhase时启动崩溃求助

问题现象 #

• 应用启动时出现间歇性崩溃，崩溃瞬间会闪显暗屏，主屏状态栏（时间、电量等）异常横向旋转并右对齐，随后屏幕消失，应用无法正常启动
• 重新点击应用图标通常能正常进入应用
• 只要注释掉@Environment(.scenePhase) private var phase或.backgroundTask(.appRefresh("UpdateBadge")) {}其中任意一段代码，崩溃就不再出现

最小复现条件 #

• 仅在真机环境下可复现，连续启动并退出应用10-20次大概率触发（实际应用中偶见首次启动就崩溃）
• 已完成必要配置：
  • 在「Signing & Capabilities」中添加包含「Background Fetch」的「Background Modes」权限
  • 在「Info.plist」中将「UpdateBadge」添加到「Permitted background task scheduler identifier」列表
• 复现代码：

struct ToyBackgroundTasksApp: App {
    
    @Environment(.scenePhase) private var phase
    
    var sharedModelContainer: ModelContainer = {
        let schema = Schema([
            Item.self,
        ])
        let modelConfiguration = ModelConfiguration(schema: schema, isStoredInMemoryOnly: false)

        do {
            return try ModelContainer(for: schema, configurations: [modelConfiguration])
        } catch {
            fatalError("Could not create ModelContainer: \(error)")
        }
    }()

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
        .modelContainer(sharedModelContainer)
        .backgroundTask(.appRefresh("UpdateBadge")) {
            print("background task")
        }
    }
}

原因分析 #

这是SwiftUI框架的一个已知层级冲突bug：当在App结构体中同时声明@Environment(.scenePhase)属性，并给WindowGroup附加.backgroundTask(.appRefresh)修饰符时，应用启动阶段的场景生命周期初始化逻辑与后台任务调度逻辑发生冲突，导致UIKit底层的窗口、状态栏布局异常，最终触发崩溃。问题的间歇性源于后台任务调度时机的不确定性，只有当后台任务刚好在场景初始化的临界节点触发时，才会触发这个布局冲突。

解决方案 #

方案1：将scenePhase监听移至View层级（推荐） #

不在App结构体中直接声明@Environment(.scenePhase)，而是把场景状态的监听逻辑放到根视图（如ContentView）或者专门的生命周期管理视图中，彻底避开App层级的逻辑冲突：

struct ContentView: View {
    @Environment(.scenePhase) private var phase
    
    var body: some View {
        Text("Hello, World!")
            .onChange(of: phase) { newPhase in
                // 在这里处理场景状态变化的逻辑
                switch newPhase {
                case .active:
                    print("应用进入前台活跃状态")
                case .inactive:
                    print("应用进入非活跃状态")
                case .background:
                    print("应用进入后台")
                @unknown default:
                    break
                }
            }
    }
}

这种方式从根源上避免了两个API在App层级的冲突，是最稳定可靠的解决办法。

方案2：延迟注册后台任务（临时过渡） #

如果业务需求必须在App层级保留scenePhase监听，可以尝试通过延迟注册后台任务的方式，避开应用启动的临界冲突期：

struct ToyBackgroundTasksApp: App {
    @Environment(.scenePhase) private var phase
    @State private var enableBackgroundTask = false
    
    var sharedModelContainer: ModelContainer = {
        let schema = Schema([Item.self])
        let modelConfiguration = ModelConfiguration(schema: schema, isStoredInMemoryOnly: false)
        do {
            return try ModelContainer(for: schema, configurations: [modelConfiguration])
        } catch {
            fatalError("Could not create ModelContainer: \(error)")
        }
    }()

    var body: some Scene {
        WindowGroup {
            ContentView()
                .onAppear {
                    // 延迟1秒注册后台任务，避开启动阶段的初始化冲突
                    DispatchQueue.main.asyncAfter(deadline: .now() + 1) {
                        enableBackgroundTask = true
                    }
                }
        }
        .modelContainer(sharedModelContainer)
        .background(
            Group {
                if enableBackgroundTask {
                    EmptyView()
                        .backgroundTask(.appRefresh("UpdateBadge")) {
                            print("background task")
                        }
                }
            }
        )
    }
}

这种方式属于临时规避手段，稳定性不如方案1，仅适合作为过渡方案使用。

方案3：升级系统与开发工具版本 #

苹果后续发布的iOS正式版本（如iOS 17.4及以后）可能已经修复了这个框架bug，尝试将测试设备升级到最新iOS版本，同时使用最新版Xcode编译项目，验证问题是否解决。

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