GRDB.swift 中关于数据查询方法的优化思考

在 Swift 数据库框架 GRDB.swift 的使用过程中，开发者经常会遇到需要从数据库中查询单条记录的场景。框架提供了两种主要的查询方法：fetchOne 和 find，它们虽然功能相似，但在错误处理和返回类型上有着重要的设计差异。

两种查询方法的对比

fetchOne 方法是 GRDB.swift 中较早引入的查询方式，其设计遵循了 SQLite 的原生行为模式。当查询的记录不存在时，它不会抛出错误，而是简单地返回 nil。这种设计在很多场景下非常实用，特别是当记录不存在是业务逻辑中的正常情况时。

// 使用 fetchOne 的典型场景
if let record = try Record.fetchOne(db, id: someID) {
    // 记录存在时的处理
} else {
    // 记录不存在的正常处理
}

而 find 方法是后来加入的（从 v6.5.0 版本开始），它采用了不同的设计哲学。当查询的记录不存在时，它会抛出 RecordError.recordNotFound 错误。这种方式更适合那些业务逻辑上要求记录必须存在的场景。

// 使用 find 的典型场景
do {
    let record = try Record.find(db, id: someID)
    // 记录存在的处理
} catch RecordError.recordNotFound {
    // 记录不存在的错误处理
}

设计哲学与适用场景

这两种方法的设计反映了不同的编程哲学和业务需求：

1. fetchOne 的适用场景：

   • 记录可能存在也可能不存在的正常业务逻辑
   • 需要明确区分"记录不存在"和"查询出错"的情况
   • 与 Swift 可选值模式天然契合的代码风格

2. find 的适用场景：

   • 记录理论上应该存在的业务场景
   • 需要将"记录不存在"视为异常情况的处理
   • 希望避免频繁解包可选值的代码风格

实际开发中的选择建议

在实际开发中，选择哪种方法取决于具体的业务需求：

• 当记录不存在是业务逻辑中的正常情况时（如用户查询一个可能不存在的条目），使用 fetchOne 更为合适。
• 当记录理论上应该存在（如根据主键查询应该有对应记录），或者记录不存在应该被视为错误时，使用 find 可以让代码更加简洁。

GRDB.swift 同时提供这两种方法，给了开发者根据具体场景选择最合适工具的自由，这也是该框架设计周到的一个体现。理解这两种方法的区别和适用场景，可以帮助开发者写出更清晰、更符合业务逻辑的数据库操作代码。