Xcode 14.1报错：UINavigationBar解码异常或代理配置错误求助

一、报错含义 #

该断言报错表示UINavigationBar的配置与所属UINavigationController不一致，触发原因分为两种：

• Storyboard解码时发现UINavigationBar处于"解锁"状态，未和对应的UINavigationController正确绑定
• UINavigationBar的delegate设置不符合系统规范

二、报错原文引用 #

[Assert] UINavigationBar decoded as unlocked for UINavigationController, or navigationBar delegate set up incorrectly. Inconsistent configuration may cause problems. navigationController=<UINavigationController: 0x13b80c600>, navigationBar=<UINavigationBar: 0x13b5079f0; frame = (0 0; 0 50); opaque = NO; autoresize = W; layer = <CALayer: 0x600000f56620>> delegate=0x13b80c600

三、解决方法 #

• 检查Storyboard中的Navigation Controller：选中导航控制器，确认其Navigation Bar未被手动移除或修改层级绑定关系
• 重置导航控制器：删除当前嵌入的Navigation Controller，重新通过Editor -> Embed In -> Navigation Controller操作嵌入
• 禁止手动修改delegate：UINavigationController会自动成为其Navigation Bar的delegate，不要在代码中手动替换这个关联

四、代码创建导航控制器的正确示例 #

如果需要通过代码创建，写法如下：

let rootVC = YourRootViewController()
let navVC = UINavigationController(rootViewController: rootVC)
// 不要手动设置 navVC.navigationBar.delegate = 其他对象

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