NavigationSplitView子SwiftUI视图SwiftData环境上下文访问崩溃及@Query失效问题

问题背景 #

我有一个可通过NavigationLink访问的ChildView，会显示在NavigationSplitView的详情面板中：

NavigationSplitView {
  ListView()
} detail: {
}

并通过以下方式配置导航目标：

.navigationDestination(for: ChildModel.self) { post in
   ChildView()
}

ChildView中声明了用于获取模型上下文的Environment属性：

@Environment(\.modelContext) private var modelContext

同时使用SwiftData的@Query属性获取所有存储的DbModel对象：

@Query private var dbModel: [DbModel]

但@Query始终返回空数据（实际存在数据），且出现警告：

Set a .modelContext in view's environment to use Query

尝试移除@Query并在ChildView的构造方法中使用FetchDescriptor：

init() {
  let predicate = #Predicate<DbModel> {
    $0.id == self.id
  }
  let descriptor = FetchDescriptor<DbModel>(predicate: predicate)
  if let models = try? modelContext.fetch(descriptor) {
    /// do something here
  }
}

会触发崩溃：

Thread 1: Fatal error: 'try!' expression unexpectedly raised an error: SwiftData.SwiftDataError(_error: SwiftData.SwiftDataError._Error.loadIssueModelContainer)

同时伴随警告：

Accessing Environment's value outside of being installed on a View. This will always read the default value and will not update.

改用应用启动后存储的全局共享modelContext引用则可以正常工作：

if let models = try? AppController.shared.modelContextReference.fetch(descriptor) {

需要澄清以下两点：

1. 如何从SwiftUI角度确保ChildView能通过环境访问modelContext，使@Query返回正确结果且无警告（无需借助类对象中的存储引用）？
2. 已知@Query会在数据变化时自动更新视图以保持同步，但如果被迫在视图构造方法中使用FetchDescriptor，是否能实现同样的自动更新？即依赖.init()中的FetchDescriptor而非@Query的视图，会在DbModel集合变化时自动更新吗？

补充背景：我只关心与ChildView相关（即id相同）的DbModel结果，因此也好奇——在无法动态查询的情况下，这种方式是否与带有静态过滤条件的@Query性能表现相似。

问题解答 #

1. 确保ChildView通过环境获取modelContext并让@Query正常工作 #

核心问题是ChildView初始化时未正确接收到带SwiftData上下文的环境，且@Query的使用方式有误，按以下步骤修复：

• 根视图注入SwiftData容器
  必须在App的根层级配置SwiftData容器，让整个视图树继承modelContext环境：

  @main
  struct YourApp: App {
      var body: some Scene {
          WindowGroup {
              NavigationSplitView {
                  ListView()
              } detail: {
              }
          }
          .modelContainer(for: [ChildModel.self, DbModel.self]) // 注册所有需要的模型
      }
  }
  

  容器会自动将modelContext注入环境，所有子视图只要在该层级内就能访问到。

• 正确配置带过滤条件的@Query
  通过ChildView的初始化参数传递目标id，在初始化时绑定@Query的过滤条件：

  struct ChildView: View {
      private let targetId: UUID
      @Query private var matchedDbModels: [DbModel]
      
      init(targetId: UUID) {
          self.targetId = targetId
          // 初始化@Query时绑定过滤规则
          _matchedDbModels = Query(filter: #Predicate<DbModel> { $0.id == targetId })
      }
      
      var body: some View {
          // 使用matchedDbModels渲染视图
      }
  }
  

  导航目标中传递id：

  .navigationDestination(for: ChildModel.self) { post in
      ChildView(targetId: post.id)
  }
  

  这种方式下，@Query会自动绑定到环境中的modelContext，不会出现警告，且能正确返回匹配数据。

2. 构造方法中使用FetchDescriptor能否实现自动更新？ #

不能。视图的init()仅在首次创建时执行一次，通过FetchDescriptor获取的数据是静态的，不会监听后续数据库变化。若要实现自动更新，需手动监听SwiftData的数据变更：

• 手动监听实现方式
  通过modelContext.publisher()监听数据变更，触发重新查询：

  struct ChildView: View {
      private let targetId: UUID
      @Environment(\.modelContext) private var modelContext
      @State private var matchedDbModels: [DbModel] = []
      
      var body: some View {
          // 渲染matchedDbModels
      }
      .onAppear {
          fetchModels()
      }
      // 监听DbModel类型的所有变更，触发重新查询
      .onReceive(modelContext.publisher(for: DbModel.self)) { _ in
          fetchModels()
      }
      
      private func fetchModels() {
          let descriptor = FetchDescriptor<DbModel>(predicate: #Predicate { $0.id == targetId })
          do {
              matchedDbModels = try modelContext.fetch(descriptor)
          } catch {
              print("查询失败：\(error)")
          }
      }
  }
  

  但这种方式更新粒度较粗——任何DbModel的变化都会触发重新查询，而@Query会精准跟踪匹配条件的数据变化，仅在相关数据更新时刷新视图。

性能对比：手动FetchDescriptor vs 静态过滤的@Query #

• @Query是SwiftUI与SwiftData深度整合的API，具备以下优化：
  1. 懒加载数据，仅在需要时获取；
  2. 精准监听匹配条件的数据变更，避免不必要的视图刷新；
  3. 自动处理数据缓存与更新，性能更优。
• 手动使用FetchDescriptor的方式，即使添加监听，也无法达到@Query的精准优化效果，数据量较大时差异会更明显。若必须用手动查询，建议监听特定对象的变更（而非整个类型），减少不必要的查询次数。

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