近日，多位 iOS 开发者反映，在将 Xcode 项目迁移至使用 SceneDelegate 的新架构后，遇到了一个令人头疼的问题：原本正常的 UIToolbar 中的 IBAction 事件突然无法触发。这一 Bug 迅速在国内外开发者社区引发热议，许多团队因此被迫回退至旧版 AppDelegate 配置，或耗费大量时间排查定位。本文将梳理这一问题的现象、可能原因及社区提供的临时解决方案。

问题背景：SceneDelegate 的普及与潜在兼容性挑战

自 iOS 13 起，Apple 引入了 UIScene 和 SceneDelegate 的概念，旨在支持多窗口（iPadOS）以及更灵活的应用生命周期管理。Xcode 11 之后的模板默认采用 SceneDelegate 结合 SwiftUI 或 UIKit，而经典的单窗口 AppDelegate 方案逐渐边缘化。然而，这一架构变更并非一帆风顺——许多开发者发现，在看似遵循了 Apple 规范后，某些 UIKit 组件的行为发生了微妙变化。

核心故障：UIToolbar 按钮 IBAction 失效

在 Reddit、Stack Overflow 以及 Apple 开发者论坛上，大量用户报告了以下症状：在项目的 AppDelegate 中配置了窗口的根视图控制器，并将界面切换到了 SceneDelegate 配置后，通过 UIToolbar 放置的 UIBarButtonItem 所绑定的 IBAction 方法不再被调用。按钮仍可显示和点击（有高亮反馈），但 target-action 机制完全失效。

具体而言，当开发者通过 Interface Builder 拖拽按钮连接到 ViewController 中的 IBAction，或者在代码中手动 addTarget:action: 时，点击按钮后 action 方法不执行。但同一 ViewController 中的其他按钮（例如 UIButton）或 NavigationBar 上的 UIBarButtonItem 往往正常。问题似乎只局限于 UIToolbar。

排查过程：原因指向窗口层级与事件链

经过深入调试，开发者社区初步定位了问题根源。在 SceneDelegate 模式下，UIWindow 的生命周期由 UIScene 管理，而 UIToolbar 作为 UINavigationController 的一部分，其事件响应依赖于 UIApplication 的 sendAction:to:from:forEvent: 方法。部分开发者发现，如果 UIToolbar 是在 viewDidLoad 中通过 Interface Builder 加载的，其 target 虽然正确指向了 ViewController，但由于窗口的 first responder 链尚未完全建立，UIToolbar 的 UIBarButtonItem 无法正确识别响应者，导致 IBAction 被忽略。

另一个关键线索是：当项目仍然使用 AppDelegate 中的 self.window.rootViewController 设置时，问题不存在。这表明 SceneDelegate 的 UISceneSession 生命周期与传统的窗口构建方式之间存在初始化时序差异。此外，某些开发者报告问题会在 iOS 14 及更高版本上发生，而在 iOS 13 上偶发，暗示可能与系统版本更新引入的响应链优化有关。

社区提供的临时解决方案

面对这一顽疾，开发者们探索了多种变通方法。以下是较为常见的几种：

方案一：在 SceneDelegate 中手动设置窗口的 rootViewController

在 scene(_:willConnectTo:options:) 方法中，使用类似 AppDelegate 中的方式手动创建窗口并设置根控制器，而不是依赖 Storyboard 的 Initial View Controller。例如：

guard let windowScene = (scene as? UIWindowScene) else { return }
let window = UIWindow(windowScene: windowScene)
let storyboard = UIStoryboard(name: "Main", bundle: nil)
let vc = storyboard.instantiateInitialViewController()
window.rootViewController = vc
self.window = window
window.makeKeyAndVisible()

这种方法重新确立了与旧版一致的响应链构建顺序。

方案二：将 UIToolbar 的初始化延迟到 viewDidAppear

通过在 viewWillAppear 或 viewDidAppear 中重新配置 UIToolbar 的按钮 target，强制在窗口就绪后绑定：

override func viewDidAppear(_ animated: Bool) {
    super.viewDidAppear(animated)
    // 重新设置 toolbar 按钮的 target
    toolbarItems?.forEach { item in
        item.target = self
        item.action = #selector(someAction)
    }
}

方案三：使用代码创建 UIToolbar 而非 Interface Builder

部分开发者发现，完全通过代码创建 UIToolbar 并手动添加到 UINavigationController 的 toolbar 属性后，IBAction 恢复正常，提示问题可能与 Xib/Storyboard 的解析加载机制相关。

方案四：升级 Xcode 并清理构建缓存

少数案例中，重启 Xcode、清理 DerivedData 并重新编译后，问题自动消失。这可能归因于项目缓存导致的链接异常。

Apple 官方回应与未来展望

截至目前，Apple 尚未就此问题发布官方技术文档或补丁声明。但考虑到该 Bug 在 Xcode 13~15 的多个版本中皆有报告，且与 SceneDelegate 深度耦合，开发社区普遍希望 Apple 能在 WWDC 2024 后的新版本 iOS 或 Xcode 中修复这一底层响应链问题。同时，有经验的工程师建议仍坚持使用 AppDelegate 架构的团队审慎评估迁移收益，避免在关键项目中使用 SceneDelegate 的多窗口特性时遭遇此类隐蔽故障。

结语

一次看似普通的架构升级，暴露了 UIKit 在状态管理上的历史复杂性。对广大 iOS 开发者而言，UIToolbar 的 IBAction 失灵不仅是一次调试挑战，更是对依赖旧框架假设的警示。在 Apple 统一响应链之前，手动确保窗口与响应者链的初始化时序，或许是当前最稳妥的保障。我们也提醒读者，如遇到类似问题，优先尝试上述方案，并积极参与社区讨论，共同推动问题解决。