SwiftData Predicate崩溃：左侧无法使用NULL问题求助

环境信息 #

• Xcode版本：15.3
• 目标系统：macOS Sonoma 14.4
• Swift版本：5

问题代码 #

@AppStorage(UserDefaults.Constants.selectedFilterName) static var selectedFilterName: String?
@Query(filter: #Predicate<Filter> {
    $0.name == (selectedFilterName ?? "")
}) var selectedFilters: [Filter]

模型定义 #

@Model
class Filter: Hashable, Identifiable {
    var id: String { name }
    let name: String
}

崩溃调用栈 #

can't use NULL on left hand side
(
    0   CoreFoundation                      0x000000019c17eccc __exceptionPreprocess + 176
    1   libobjc.A.dylib                     0x000000019bc66788 objc_exception_throw + 60
    2   CoreData                            0x00000001a29cb744 -[NSSQLGenerator newSQLStatementForRequest:ignoreInheritance:countOnly:nestingLevel:nestIsWhereScoped:requestContext:] + 4040
    3   CoreData                            0x00000001a29ca62c -[NSSQLiteAdapter newSelectStatementWithFetchRequestContext:ignoreInheritance:] + 140
    4   CoreData                            0x00000001a29ca564 -[NSSQLFetchRequestContext _createStatement] + 52
    5   CoreData                            0x00000001a29ca34c -[NSSQLFetchRequestContext fetchStatement] + 172
    6   CoreData                            0x00000001a29ca22c -[NSSQLFetchRequestContext executeRequestCore:] + 28
    7   CoreData                            0x00000001a29c9e94 -[NSSQLStoreRequestContext executeRequestUsingConnection:] + 300
    8   CoreData                            0x00000001a29c9bbc __52-[NSSQLDefaultConnectionManager handleStoreRequest:]_block_invoke + 60

错误原因分析 #

这个错误的核心是selectedFilterName为可选String类型，当它在UserDefaults中对应的值为NULL时，即使你在Predicate中使用?? ""提供默认空字符串，CoreData在将Swift Predicate转换为SQL语句的过程中，仍可能错误地生成包含NULL的比较逻辑，导致SQLite抛出"can't use NULL on left hand side"的语法错误。

解决办法 #

方法1：将可选类型改为非可选默认值 #

把selectedFilterName定义为非可选String，默认值设为空字符串，从根本上避免UserDefaults中出现NULL值：

@AppStorage(UserDefaults.Constants.selectedFilterName) static var selectedFilterName: String = ""

@Query(filter: #Predicate<Filter> {
    $0.name == selectedFilterName
}) var selectedFilters: [Filter]

方法2：显式处理可选值的Predicate逻辑 #

如果必须保留可选类型，在Predicate中显式分支处理nil的情况，确保生成的SQL不会出现NULL比较：

@Query(filter: #Predicate<Filter> {
    guard let filterName = selectedFilterName else {
        return $0.name == ""
    }
    return $0.name == filterName
}) var selectedFilters: [Filter]

补充：初始化UserDefaults默认值 #

如果坚持使用可选类型，可在App启动时提前给UserDefaults设置默认值，避免底层出现NULL：

// 在App初始化代码中添加
if UserDefaults.standard.string(forKey: UserDefaults.Constants.selectedFilterName) == nil {
    UserDefaults.standard.set("", forKey: UserDefaults.Constants.selectedFilterName)
}

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