Swift项目构建报.storyboard Illegal Configuration错误 打开文件无异常怎么办

Xcode的Interface Builder编辑态仅会做当前打开文件的基础配置校验，不会触发构建阶段的全量规则校验，所以会出现手动打开Storyboard无标红、但构建时触发报错的情况，可按照以下步骤排查解决：

• 查看完整构建报错详情
  点击Xcode左侧导航栏的报告图标，找到本次失败的构建记录，点击Illegal Configuration报错行左侧的展开箭头，完整报错信息通常会直接定位到具体的控制器、控件，以及不合法的配置类型，比如属性版本不兼容、关联关系失效等。
• 校验部署目标兼容性
  这类报错最常见的原因是控件使用了高于项目部署目标版本的属性：比如使用了仅iOS 16支持的UIHostingConfiguration，但项目Deployment Target设置为iOS 15，编辑态不会触发标红，构建时才会报错。
  选中对应Storyboard文件，打开右侧文件检查器，查看「Builds for」配置项，确认是否和项目全局部署目标一致，不一致的话修改为匹配的版本即可。
• 清理失效的关联关系
  右键点击Storyboard场景中的控制器图标，打开「Outlets」和「Received Actions」列表，如果存在带黄色感叹号的条目，说明之前关联到Swift代码的IBOutlet、IBAction已经被删除，但Storyboard中还保留了关联记录，删除这些无效关联即可解决报错。
• 清理Xcode缓存重试
  按Command + Shift + K快捷键清理构建缓存，关闭Xcode后删除~/Library/Developer/Xcode/DerivedData目录下对应项目的缓存文件夹，重新打开Xcode执行构建。
• 源码模式排查Storyboard配置
  右键点击Storyboard文件，选择「Open As -> Source Code」，查看Storyboard的XML源码，搜索报错日志中提到的控件ID、属性关键字，直接修改不合法的配置项，修改完成后切回Interface Builder模式校验即可。

报错参考截图：

内容的提问来源于stack exchange，提问作者Newbie Swift Coder