SwiftData多组件键路径Predicate不支持问题求助

问题背景 #

在SwiftData中定义了Word与Folder的多对多关系、Word与Flashcard的一对一关系，查询指定Folder下的Word正常，但查询该Folder下的Flashcard时，报错“Predicate does not support keypaths with multiple components”。

模型定义 #

@Model
class Word {
    @Attribute(.unique)
    let id: UUID
    
    var title: String
    
    @Relationship(inverse: \Folder.words)
    var folders: [Folder]
    
    @Relationship(deleteRule: .cascade, inverse: \Flashcard.word)
    var flashcard: Flashcard!
}

@Model
class Folder {
    @Attribute(.unique)
    let id: UUID
    
    var title: String
    
    @Relationship
    var words: [Word]
}

@Model
class Flashcard {
    @Attribute(.unique)
    let id: UUID
    
    @Relationship
    var word: Word!
    
    var due: Date
}

原错误查询代码 #

@Query var cards: [Flashcard]

init(folder: Folder) {
    let fid = folder.id
    
    _cards = Query(
        filter: #Predicate<Flashcard> {
            $0.word.folders.contains(where: {$0.id == fid})
        }
    )
}

解决方案：使用子查询（Subquery） #

SwiftData的#Predicate不支持直接在多层嵌套关系中使用contains(where:)，但可以通过子查询实现跨层级的关系过滤：

写法一：通过子查询计数判断 #

@Query var cards: [Flashcard]

init(folder: Folder) {
    let fid = folder.id
    _cards = Query(
        filter: #Predicate<Flashcard> {
            // 子查询判断当前Flashcard关联的Word是否包含目标Folder
            Subquery($0.word.folders, where: { $0.id == fid }).count > 0
        }
    )
}

写法二：使用exists()判断 #

@Query var cards: [Flashcard]

init(folder: Folder) {
    let fid = folder.id
    _cards = Query(
        filter: #Predicate<Flashcard> {
            Subquery($0.word.folders, where: { $0.id == fid }).exists()
        }
    )
}

原理说明 #

原报错是因为SwiftData的查询引擎无法解析$0.word.folders.contains(where:)这种多层嵌套的关系过滤逻辑，而子查询是官方支持的跨关系层级查询方式，能够明确告知查询引擎需要关联的层级和过滤条件，从而在数据库层面完成高效查询，避免内存中处理大量数据。

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