iOS Swift原生应用content_available通知后台不弹窗，需保留参数求助

我之前切换到Swift原生项目时也碰到过几乎一模一样的问题，折腾了好一阵才搞定，给你几个亲测有效的方案，都能在保留content_available: true（满足Android需求）的前提下让iOS后台弹窗通知：

1. 调整APNs推送Payload的结构 #

iOS对静默通知和可弹窗通知的判断逻辑很明确：如果Payload里只有content_available: true，会被当成静默通知（只唤醒APP后台处理，不弹窗）；但如果同时包含alert（或拆分的title/body）、sound这类展示类字段，系统就会触发弹窗，同时依然保留content_available: true的后台唤醒能力。

给你一个标准的Payload示例：

{
  "aps": {
    "alert": {
      "title": "新消息提醒",
      "body": "您有一条未读消息"
    },
    "content_available": true,
    "sound": "default",
    "badge": 1
  },
  "custom_data": "你的业务自定义数据"
}

注意：alert字段是核心，只要存在有效内容，iOS就会触发弹窗，同时content_available: true依然会生效，Android那边也能正常依赖这个参数。

2. 检查iOS原生项目的推送配置 #

这是很多原生新手容易忽略的点，必须确保以下配置都到位：

• 开启后台推送模式：在Xcode中打开项目的Capabilities标签，找到Background Modes，勾选Remote notifications选项，这样APP才能在后台接收并处理推送。
• 正确请求推送权限：在APP启动时，要向用户请求包含弹窗、声音的通知权限，示例代码：

import UserNotifications

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound, .badge]) { granted, error in
        if granted {
            DispatchQueue.main.async {
                application.registerForRemoteNotifications()
            }
        }
    }
    return true
}

• 正确处理后台推送回调：在AppDelegate（或SceneDelegate，如果用了场景模式）中，实现后台推送的回调方法，务必调用completionHandler，否则系统可能不会展示弹窗：

func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
    // 这里可以处理你的自定义业务逻辑
    completionHandler(.newData) // 必须调用，告诉系统有新数据，触发弹窗
}

3. 验证用户的通知权限状态 #

有时候用户可能在系统设置里关闭了APP的通知权限，或者禁用了“后台通知”，你可以在APP里检测权限状态，引导用户开启：

UNUserNotificationCenter.current().getNotificationSettings { settings in
    if settings.authorizationStatus != .authorized || settings.alertSetting != .enabled {
        // 引导用户去系统设置开启通知权限
        DispatchQueue.main.async {
            let alert = UIAlertController(title: "通知权限未开启", message: "请前往设置开启通知权限，以便接收消息提醒", preferredStyle: .alert)
            alert.addAction(UIAlertAction(title: "去设置", style: .default) { _ in
                guard let settingsUrl = URL(string: UIApplication.openSettingsURLString) else { return }
                UIApplication.shared.open(settingsUrl)
            })
            alert.addAction(UIAlertAction(title: "取消", style: .cancel))
            // 获取当前顶层ViewController来弹出提示
            if let topVC = UIApplication.shared.keyWindow?.rootViewController {
                topVC.present(alert, animated: true)
            }
        }
    }
}

补充说明 #

之前Ionic混合应用能正常工作，是因为Capacitor/Cordova框架已经帮你封装好了这些配置和回调逻辑，而原生Swift项目需要手动完成这些步骤，所以才会出现“能接收但不弹窗”的情况。

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