启用C++互操作性后iOS本地通知失效问题排查

问题描述 #

我有一个基于Storyboard、Swift开发的iOS应用，原本通过UNUserNotificationCenter实现的本地通知功能运行正常，但因业务需求必须启用Build Settings -> Swift Compiler - Language -> C++ and Objective-C Interoperability选项。启用后本地通知直接失效：无报错、无崩溃，仅通知完全不显示。

已排查步骤 #

• 确认应用通知权限已正常授予，设置无异常
• 关闭互操作性选项后，通知代码可正常运行，排除代码本身逻辑问题

环境信息 #

• Xcode版本：15.0.1
• iOS部署目标：13.0
• 开发语言：Swift

相关代码 #

AppDelegate.swift #

import UIKit
import UserNotifications

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        UNUserNotificationCenter.current().delegate = self
        UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .sound, .badge]) { granted, error in
            if granted {
                print("Notification permission granted.")
            } else if let error = error {
                print("Notification permission error: \(error)")
            }
        }
        return true
    }
    
}

extension AppDelegate: UNUserNotificationCenterDelegate {
    private func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
        completionHandler([.alert, .sound])
    }
    
    func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
        completionHandler()
    }
}

MainViewController.swift #

@IBAction func submitBtn(_ sender: Any) {
    let content = UNMutableNotificationContent()
    content.title = "Testing Notification"
    content.body = "This is a test notification"
    
    let request = UNNotificationRequest(identifier: "MainViewController", content: content, trigger: nil)
    
    UNUserNotificationCenter.current().add(request) { error in
        if let error = error {
            print("MainViewControllerLog", "Error delivering notification: \(error)")
        } else {
            print("MainViewControllerLog", "Notification scheduled: \(content.title) - \(content.body)")
        }
    }
    
}

失效原因 #

问题核心在于UNUserNotificationCenterDelegate扩展中的willPresent方法被标记为private：

• UNUserNotificationCenter是基于Objective-C的系统框架，它依赖Objective-C运行时来调用代理方法
• 启用C++/Objective-C互操作性后，Swift编译器会调整跨语言交互规则，私有方法会被完全隐藏，无法被Objective-C运行时识别
• 前台展示通知必须通过willPresent方法返回展示选项，该方法无法被调用时，系统就不会显示前台通知

解决方案 #

移除willPresent方法的private修饰符，让它能被Objective-C运行时访问：

修改后的代理扩展代码：

extension AppDelegate: UNUserNotificationCenterDelegate {
    func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
        completionHandler([.alert, .sound])
    }
    
    func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
        completionHandler()
    }
}

注意事项 #

• 启用Swift与C++/Objective-C互操作性后，所有需要被Objective-C框架调用的Swift方法（如代理方法、回调）都不能标记为private，否则会被Objective-C运行时忽略
• 若需限制方法访问范围，可改用fileprivate：它在Swift中限制文件内访问，但仍能被Objective-C识别
• 启用互操作性后，建议全面检查跨语言交互的代码，确保暴露给Objective-C的方法未被错误标记为私有

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