SwiftUI+Firebase应用模拟器运行正常但真机显示黑屏如何解决？

常见原因及对应修复方法 #

• 配置文件Target归属错误 #

GoogleService-Info.plist如果未勾选对应App的Target Membership，模拟器运行时可读取项目根目录的配置文件，但真机构建时只会打包勾选了Target的文件，会导致Firebase读取配置失败，初始化卡住触发黑屏。
修复操作：右键点击项目中的GoogleService-Info.plist，打开右侧文件检查器，在Target Membership栏勾选当前App Target，重新构建运行即可。

• ATS网络权限拦截 #

真机默认开启App传输安全(ATS)限制，若Firebase相关请求未满足ATS规则会被拦截，Firebase初始化失败后会导致UI加载流程卡住。
修复操作：在Info.plist中添加对应域名的ATS例外，或临时开启允许任意HTTP请求测试，确认是ATS问题后再细化配置。

• 构建模式差异问题 #

如果真机运行用的是Release模式，开启的编译优化可能跳过部分Debug模式下才会执行的代码，比如用#if DEBUG宏包裹了根视图初始化或者Firebase初始化的逻辑，Release模式下这部分代码不会执行，就会导致根视图未被正确赋值，显示黑屏。
修复操作：将Xcode左上角运行Scheme的构建模式临时切换为Debug，运行到真机看是否还会黑屏，若问题消失就检查代码里的条件编译逻辑，把核心初始化和根视图渲染的逻辑移出Debug专属的编译条件。

• 主队列阻塞问题 #

模拟器对非主线程操作UI的容错性更高，若在非主线程执行了UI更新操作，或在App启动的生命周期方法里同步执行了Firebase的网络请求类初始化操作，会卡住主队列，导致系统判定应用启动超时，直接显示黑屏。
修复操作：打开Xcode的Main Thread Checker检测，运行到真机查看控制台是否有非主线程操作UI的警告；同时把Firebase的初始化逻辑放到异步队列执行，不要阻塞App启动流程。

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