SwiftUI中App激活后通知关联Alert无法正常显示问题排查

问题描述 #

这段简化自实际项目的SwiftUI代码存在两个核心问题：

1. App首次启动时Alert能正常弹出，但将App最小化再恢复激活状态时，尽管控制台有日志输出，Alert却完全不显示，该问题可在任意模拟器复现。
2. 控制台中Showing alert会打印3次，不符合预期的仅打印一次的结果；即使移除通知相关代码，直接在onChange中设置showAlert=true，Alert仍会出现有时显示有时不显示的情况。

控制台日志输出 #

Showing alert
Showing alert
Active
Got notification
Showing alert

示例代码 #

import SwiftUI

struct ContentView: View {
    let notificationName = Notification.Name("testnotification")
    @State private var showAlert = false
    @Environment(\.scenePhase) var scenePhase
    
    var body: some View {
        VStack {
            Text("Hello, world!")
        }
        .onChange(of: scenePhase) { newPhase in
            if newPhase == .active {
                print("Active")
                NotificationCenter.default.post(name: notificationName, object: nil, userInfo: [:])
            }
        }
        .onReceive(NotificationCenter.default.publisher(for: notificationName)) { _ in
            showAlert = true
            print("Got notification")
        }
        .alert("HAVE AN ALERT", isPresented: $showAlert) {
            let _ = print("Showing alert")
            Button("OK", role: .cancel) {
                print("alert button pressed")
            }
        }
        .padding()
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView()
    }
}

问题分析 #

1. Showing alert重复打印的原因：
   .alert的闭包会被SwiftUI多次调用——包括视图初始渲染、状态变更、场景切换后的视图更新等，所以里面的print语句会执行多次，但这并不代表Alert弹出了多次，只是闭包被触发了。
2. App恢复激活时Alert不显示的原因：
   • 后台恢复激活时，视图更新流程和状态设置的时机可能冲突，直接设置showAlert可能因为视图未完全完成激活渲染，导致状态变更未被正确捕获。
   • 首次弹出Alert后如果没有将showAlert重置为false，再次设置true时状态无变化，Alert不会触发。

解决方案 #

方案1：修复状态触发逻辑+规范日志打印

确保showAlert每次触发前先重置为false，再异步设置为true；同时把日志移到onChange监听showAlert的变化，避免闭包重复执行带来的干扰：

import SwiftUI

struct ContentView: View {
    let notificationName = Notification.Name("testnotification")
    @State private var showAlert = false
    @Environment(\.scenePhase) var scenePhase
    
    var body: some View {
        VStack {
            Text("Hello, world!")
        }
        .onChange(of: scenePhase) { newPhase in
            if newPhase == .active {
                print("Active")
                // 先重置状态，再异步触发，确保状态变更被捕获
                showAlert = false
                DispatchQueue.main.async {
                    showAlert = true
                }
                // 如需保留通知逻辑，同样处理
                // NotificationCenter.default.post(name: notificationName, object: nil, userInfo: [:])
            }
        }
        .onReceive(NotificationCenter.default.publisher(for: notificationName)) { _ in
            showAlert = false
            DispatchQueue.main.async {
                showAlert = true
            }
            print("Got notification")
        }
        // 仅在Alert实际弹出时打印日志
        .onChange(of: showAlert) { isShowing in
            if isShowing {
                print("Showing alert")
            }
        }
        .alert("HAVE AN ALERT", isPresented: $showAlert) {
            Button("OK", role: .cancel) {
                print("alert button pressed")
            }
        }
        .padding()
    }
}

方案2：用task修饰器处理场景激活

利用task修饰器监听场景状态，确保在视图状态稳定后再触发Alert：

import SwiftUI

struct ContentView: View {
    let notificationName = Notification.Name("testnotification")
    @State private var showAlert = false
    @Environment(\.scenePhase) var scenePhase
    
    var body: some View {
        VStack {
            Text("Hello, world!")
        }
        .task(id: scenePhase) {
            if scenePhase == .active {
                print("Active")
                // 短暂延迟确保视图完成激活后的更新
                await Task.sleep(100_000_000) // 0.1秒延迟
                showAlert = true
            }
        }
        .onChange(of: showAlert) { isShowing in
            if isShowing {
                print("Showing alert")
            }
        }
        .alert("HAVE AN ALERT", isPresented: $showAlert) {
            Button("OK", role: .cancel) {
                print("alert button pressed")
            }
        }
        .padding()
    }
}

关键注意事项 #

• 不要在.alert的闭包里执行打印等副作用操作，这个闭包的执行时机和Alert弹出时机并非完全绑定。
• 处理场景状态变化时，异步执行状态设置或添加短暂延迟，能避免视图更新和状态变更的时机冲突。
• 必须保证showAlert从false变为true才能触发Alert，所以每次触发前要重置状态。

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