Xcode14.3构建iOS应用启动崩溃：无法手动设置UINavigationBar代理

问题分析 #

Xcode14.3对应的iOS16.4 SDK强化了对UINavigationBar代理设置的校验——被UINavigationController管理的导航栏，不允许手动设置其delegate属性，而Xcode14.1及之前的版本没有严格检测这个违规操作，导致升级后触发崩溃，且崩溃发生在自定义代码执行前，说明问题出在Storyboard加载或系统初始化阶段。

排查与解决方案 #

1. 检查所有UINavigationController关联代码 #

遍历项目中所有自定义的UINavigationController子类，以及子故事板里的导航控制器：

• 查看init(coder:)、awakeFromNib方法，有没有直接设置navigationBar.delegate = self这类代码；
• 排查是否通过Objective-C分类、Runtime方法交换等方式，间接修改了导航栏的delegate。

如果找到这类代码，替换为设置UINavigationController的delegate，因为导航栏的代理事件会通过导航控制器的delegate回调传递，示例：

// 错误写法（会崩溃）
navigationBar.delegate = self

// 正确写法
self.delegate = self // 让UINavigationController子类自身成为其delegate

2. 检查Storyboard可视化设置 #

• 打开所有涉及UINavigationBar的Storyboard，选中导航栏，查看Identity Inspector：是否给导航栏设置了自定义类，且该类内部设置了自身为delegate；
• 查看User Defined Runtime Attributes：有没有添加delegate属性的绑定，比如绑定到某个控制器对象。

3. 排查第三方依赖 #

如果项目使用了自定义导航栏、页面路由类等第三方库，优先更新到最新版本——很多库已经针对iOS16.4 SDK修复了这个问题。如果更新后仍有问题，查看库的源码或Issue列表，确认是否存在直接设置navigationBar.delegate的代码，必要时临时修改库代码或替换方案。

4. 清理项目缓存 #

Xcode升级后缓存可能导致异常，执行以下操作：

• 按下Cmd+Shift+K清理Build Folder；
• 删除Derived Data（可通过Xcode偏好设置→Locations→Derived Data路径手动删除）；
• 重启Xcode后重新编译。

5. 检查子故事板的根控制器 #

你的根是UITabBarController，每个标签页对应故事板引用，检查这些子故事板的根控制器：

• 如果是UINavigationController，按照上面的步骤排查其导航栏设置；
• 如果是普通视图控制器，检查是否通过代码或Storyboard嵌入了导航栏，且存在违规设置delegate的情况。

内容的提问来源于stack exchange，提问作者David.Chu.ca