SwiftData使用fetchCount添加propertiesToFetch出现语法错误

问题原因 #

当你在SwiftData的FetchDescriptor中把自定义Codable结构体类型的属性（比如Item里的information）直接加入propertiesToFetch时，SwiftData生成SQL语句会出现错误——它会把结构体内部的字段直接拼接成无分隔的字符串（比如ZFIELDt0.ZFIELD2t0.ZFIELD3），导致SQL语法解析失败，最终返回0并抛出控制台错误。

解决方案 #

1. 统计模型数量场景

fetchCount的作用是统计符合条件的模型行数，完全不需要指定propertiesToFetch，移除该配置即可正常获取数量，且不会有性能损耗：

static func count(context: ModelContext) -> Int {
    let descriptor = FetchDescriptor<Item>()
    do {
        return try context.fetchCount(descriptor)
    } catch {
        print(error)
        return 0
    }
}

2. Query场景需要字段加载优化

如果是用Query需要只加载information相关字段，不要直接指定整个结构体属性，而是明确列出结构体内部的单个字段：

// 示例：Query场景的FetchDescriptor配置
var descriptor = FetchDescriptor<Item>()
descriptor.propertiesToFetch = [\.information.field, \.information.field2, \.information.field3]

这样SwiftData会生成正确的SQL语句，分别选择每个子字段，实现部分字段加载的优化，同时避免语法错误。

补充说明 #

SwiftData目前对自定义Codable结构体作为模型属性的解析存在局限性，无法直接识别整个结构体作为propertiesToFetch的元素，必须明确指定结构体内部的具体字段才能生成正确的查询语句。

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