SwiftData中relationshipKeyPathsForPrefetching滚动列表时失效问题

在SwiftData中使用relationshipKeyPathsForPrefetching时，滚动列表时该功能似乎未生效。期望获取posts的同时一并加载所有关联的category，而非滚动列表时才加载。

相关代码如下：

struct ContentView: View {
    var body: some View {
        QueryList(
            fetchDescriptor: withCategoriesFetchDescriptor
        )
    }
    
    var withCategoriesFetchDescriptor: FetchDescriptor<Post> {
        var fetchDescriptor = FetchDescriptor<Post>()
        fetchDescriptor.relationshipKeyPathsForPrefetching = [\.category]
        return fetchDescriptor
    }
}
struct QueryList: View {        
    @Query
    var posts: [Post]

    init(fetchDescriptor: FetchDescriptor<Post>) {
        _posts = Query(fetchDescriptor)
    }

    var body: some View {
        List(posts) { post in
            VStack {
                Text(post.title)
                Text(post.category?.name ?? "")
                    .font(.footnote)
            }
        }
    }
}

@Model
final class Post {
    var title: String
    var category: Category?
    
    init(title: String) {
        self.title = title
    }
}

@Model final class Category {
    var name: String
    
    init(name: String) {
        self.name = name
    }
}

附带相关截图：

核心原因 #

问题源于SwiftData的懒加载默认行为，以及@Query初始化时预取配置的应用逻辑：

1. 即使设置了relationshipKeyPathsForPrefetching，SwiftData仍会延迟加载关联对象，直到代码真正访问关联对象的属性（比如category?.name）时才触发查询。
2. 滚动列表时，每个列表项首次渲染才会访问category?.name，此时才会执行关联对象的加载，导致你看到的“滚动时才加载”现象。

解决方案 #

方案1：确保预取配置被正确应用 #

可以在QueryList的初始化中，显式确认预取路径，避免配置被意外覆盖：

struct QueryList: View {        
    @Query
    var posts: [Post]

    init(fetchDescriptor: FetchDescriptor<Post>) {
        var descriptor = fetchDescriptor
        // 显式设置预取路径，确保配置生效
        descriptor.relationshipKeyPathsForPrefetching = [\.category]
        _posts = Query(descriptor)
    }

    // 其余代码不变
}

方案2：提前触发预取 #

在视图初始化后，提前遍历所有posts并访问关联属性，强制触发预取：

struct QueryList: View {        
    @Query
    var posts: [Post]

    init(fetchDescriptor: FetchDescriptor<Post>) {
        _posts = Query(fetchDescriptor)
        // 异步遍历，避免阻塞UI初始化
        DispatchQueue.main.async {
            // 访问category的name属性，触发预取
            _ = posts.map { $0.category?.name }
        }
    }

    // 其余代码不变
}

这样在视图加载完成后，所有category数据会被提前加载，滚动列表时不会再触发额外查询。

方案3：检查模型与容器配置 #

• 确认Post和Category的模型关系定义正确，category作为可选一对一关系，SwiftData能正确识别。
• 初始化ModelContainer时，避免设置会禁用预取的特殊配置（比如某些调试模式下的延迟加载强制开关）。

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