Swift（UIKit）本地通知异常咨询：点击按钮触发的测试通知仅在后台生效，前台无响应

这是个非常常见的坑！我刚接触本地通知的时候也踩过～核心原因是系统的默认行为限制，再加上可能你没配置好前台通知的处理逻辑，具体拆解下：

核心原因 #

• iOS系统默认规则：苹果为了避免干扰用户在前台使用App，UNUserNotificationCenter（iOS 10+的通知框架）在App处于活跃前台状态时，不会自动弹出通知横幅、播放声音或震动，只会把通知事件推送给你设置的代理（Delegate），如果没处理这个代理回调，就会看起来完全没响应。
• 未设置通知代理或未实现回调：如果你的App没有给UNUserNotificationCenter设置Delegate，或者没实现willPresent方法，系统就找不到处理前台通知的逻辑，自然不会有任何表现。

解决办法（以iOS Swift为例） #

1. 先设置通知代理
   在App启动时（比如AppDelegate的didFinishLaunchingWithOptions方法里，或者SwiftUI的App结构体中），把当前类设为通知中心的代理：

// 先确保类遵守UNUserNotificationCenterDelegate协议
class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        UNUserNotificationCenter.current().delegate = self
        // 其他初始化逻辑...
        return true
    }
}

2. 实现前台通知处理回调
   添加代理方法，告诉系统你希望前台通知如何展示：

func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
    // 根据需求选择展示选项：.banner（横幅）、.sound（声音）、.badge（角标）
    completionHandler([.banner, .sound])
}

要是你用的是跨平台框架（比如Flutter、React Native），逻辑也是类似的——需要在框架层面注册前台通知的监听，并手动触发展示逻辑，不然前台也不会有通知提示。

内容的提问来源于stack exchange，提问作者The Girl who Codes