Xcode13.4.1+Swift5下Core Data CONTAINS[cd]谓词SQL生成未实现错误解决

问题重现 #

在Core Data的Item实体中使用title CONTAINS[cd] %@谓词执行搜索时，抛出以下错误：

[error] error: SQLCore dispatchRequest: exception handling request:
<NSSQLFetchRequestContext: 0x60000311df80> , unimplemented SQL
generation for predicate : (title CONTAINS[cd] "Aib") with userInfo of
(null)

对应的搜索代码如下：

func searchBarSearchButtonClicked(_ searchBar: UISearchBar) {
    let request: NSFetchRequest<Item> = Item.fetchRequest()
    request.predicate = NSPredicate(format: "title CONTAINS[cd] %@", searchBar.text!)
    request.sortDescriptors = [NSSortDescriptor(key: "title", ascending: true)]

    do {
        itemArray = try context.fetch(request)
        toDoListTableView.reloadData()
    } catch {
        print("search error \(error)")
    }
}

核心原因 #

这个错误的本质是Core Data无法为当前属性类型生成对应的SQL查询语句，最常见的触发场景：

• Item实体中的title属性被设置为Transformable类型，而非标准String类型
• 或属性标记为String，但存储类型被错误配置为SQLite无法解析的格式

解决步骤 #

1. 修正Core Data实体属性类型（推荐） #

打开Core Data模型文件（.xcdatamodeld）：

• 选中Item实体，找到title属性
• 确认Type为String，Attribute Type为String（而非Transformable或其他自定义类型）
• 保存模型文件，执行Cmd+Shift+K清理项目后重新构建

2. 内存过滤替代方案（仅临时使用） #

如果因业务限制无法修改属性类型，只能放弃SQL层面的过滤，改为在内存中处理结果：

func searchBarSearchButtonClicked(_ searchBar: UISearchBar) {
    guard let searchText = searchBar.text?.lowercased() else { return }
    
    let request: NSFetchRequest<Item> = Item.fetchRequest()
    request.sortDescriptors = [NSSortDescriptor(key: "title", ascending: true)]

    do {
        let allItems = try context.fetch(request)
        // 内存中过滤匹配项
        itemArray = allItems.filter { item in
            guard let title = item.title?.lowercased() else { return false }
            return title.contains(searchText)
        }
        toDoListTableView.reloadData()
    } catch {
        print("search error \(error)")
    }
}

注意：该方式会先加载所有数据到内存再过滤，数据量较大时会显著影响性能，仅作为临时替代方案。

3. 调整谓词写法（兼容性尝试） #

若属性类型确认正确仍报错，可尝试等价的谓词写法规避SQL生成的兼容性问题：

// LIKE[cd]搭配通配符*，功能与CONTAINS[cd]一致
request.predicate = NSPredicate(format: "title LIKE[cd] %@", "*\(searchBar.text!)*")

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