SwiftUI报SessionStore ObservableObject缺失 预览已加environmentObject仍报错

报错表现 #

• 运行应用或渲染预览时，线程1触发致命错误：类型为SessionStore的ObservableObject未找到，提示当前视图的祖先层级中缺失针对SessionStore的View.environmentObject(_:)注入
• 完整报错文本：Fatal error: No ObservableObject of type SessionStore found. A View.environmentObject(_:) for SessionStore may be missing as an ancestor of this view.，报错断点定位在SwiftUI运行时第0行，无具体业务代码指向
• 开发者已执行的操作：在ContentView_Previews的预览闭包中添加了environmentObject(SessionStore())，崩溃仍未解决

根因定位 #

该类崩溃的触发和预览代码中的注入操作无直接关联，常见触发点为两处：

1. App正式启动的根视图层级未注入全局SessionStore实例
   预览代码仅在Xcode Canvas渲染预览视图时执行，完全不参与App正式启动、运行的构造流程。如果App入口的根视图没有挂载SessionStore到环境中，正式运行时的所有视图都无法从环境中读取到该对象，必然触发崩溃。
2. 视图分支链路的环境传递断裂
   即使在根视图完成了环境注入，如果以下视图的构造脱离了正常的环境传递链路，也会触发报错：
   • 所有声明了@EnvironmentObject var session: SessionStore的子视图（包括AuthView、HostingTabView、RegistrationProfileDataView），如果被手动构造、未经过父视图的环境传递，会直接读取失败
   • .sheet、.fullScreenCover等弹出修饰符关联的内容视图，虽然默认会继承父视图的环境，但如果父视图的环境在弹出时机未完成对象初始化，同样会触发读取失败

分步修复方案 #

1. 在项目中带@main标记的App入口实现中，全局持有并注入SessionStore实例，示例代码：

   @main
   struct YourAppNameApp: App {
       // 用@StateObject持有全局实例，避免重复初始化导致的对象不一致
       @StateObject private var sessionStore = SessionStore()
       
       var body: some Scene {
           WindowGroup {
               ContentView()
                   .environmentObject(sessionStore)
           }
       }
   }
   

2. 逐一排查所有依赖SessionStore的子视图：确认所有声明@EnvironmentObject的视图，都是通过正常的视图嵌套链路渲染，不存在脱离父环境手动构造的场景。如果存在这类手动构造的逻辑，需要在对应视图的构造链上补全environmentObject注入。
3. 清理SessionStore的冗余实现：当前类中手动实现的didChange PassthroughSubject逻辑属于冗余代码——ObservableObject协议会自动将所有@Published属性的变化转发到objectWillChange，手动实现的发布逻辑不仅无实际作用，还可能和系统自动的发布逻辑产生冲突，可直接删除该部分代码。

排查注意事项 #

• 报错定位在"SwiftUI文件第0行"是因为崩溃发生在SwiftUI运行时的视图初始化、环境读取阶段，不会指向具体业务代码行，排查时优先梳理环境对象的注入全链路，不需要在业务逻辑代码中逐行定位。
• 预览代码中的环境注入仅对预览渲染生效，不能替代正式运行时的注入逻辑。

内容的提问来源于stack exchange，提问作者Nikola S.